Glue / Client / put_asset

put_asset¶

Glue.Client.put_asset(**kwargs)¶

Creates or updates an asset in Glue Data Catalog. If the asset already exists, this operation updates it; otherwise, a new asset is created.

Request Syntax

response = client.put_asset(
    AssetTypeId='string',
    Identifier='string',
    Name='string',
    Description='string',
    Forms={
        'string': {
            'FormTypeId': 'string',
            'Content': 'string'
        }
    },
    ClientToken='string'
)

Parameters:

AssetTypeId (string) –
[REQUIRED]

The identifier of the asset type for the asset.
Identifier (string) –
[REQUIRED]

The unique identifier of the asset. If an asset with this identifier already exists, it is updated.
Name (string) –
[REQUIRED]

The name of the asset.
Description (string) – The description of the asset.
Forms (dict) –
[REQUIRED]

The forms to set on the asset, keyed by form name. Each entry specifies the form type and its JSON content.
- (string) –
  - (dict) –
    
    A form on an asset, consisting of the form type identifier and its JSON content.
    - FormTypeId (string) –
      
      The identifier of the form type that defines this form’s schema.
    - Content (string) –
      
      The JSON content of the form, conforming to the schema of the specified form type.
ClientToken (string) –
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

This field is autopopulated if not provided.

Return type:

dict

Returns:

Response Syntax

{
    'Id': 'string',
    'Name': 'string',
    'Description': 'string',
    'CreatedAt': datetime(2015, 1, 1),
    'Forms': {
        'string': {
            'FormTypeId': 'string',
            'Content': 'string'
        }
    }
}

Response Structure

(dict) –
- Id (string) –
  
  The unique identifier of the asset.
- Name (string) –
  
  The name of the asset.
- Description (string) –
  
  The description of the asset.
- CreatedAt (datetime) –
  
  The timestamp at which the asset was created.
- Forms (dict) –
  
  The forms attached to the asset, keyed by form name.
  - (string) –
    - (dict) –
      
      A form on an asset, consisting of the form type identifier and its JSON content.
      - FormTypeId (string) –
        
        The identifier of the form type that defines this form’s schema.
      - Content (string) –
        
        The JSON content of the form, conforming to the schema of the specified form type.

Exceptions

Glue.Client.exceptions.AccessDeniedException
Glue.Client.exceptions.ConcurrentModificationException
Glue.Client.exceptions.EntityNotFoundException
Glue.Client.exceptions.InternalServiceException
Glue.Client.exceptions.InvalidInputException
Glue.Client.exceptions.ThrottlingException