AWS API Changes

2019/03/11 - AWS Glue - 5 updated api methods

Changes Update glue client to latest version

BatchGetDevEndpoints (updated)

Link ¶
Changes (response)

{'DevEndpoints': {'Arguments': {'string': 'string'}}}

Returns a list of resource metadata for a given list of DevEndpoint names. After calling the ListDevEndpoints operation, you can call this operation to access the data to which you have been granted permissions. This operation supports all IAM permissions, including permission conditions that uses tags.

See also: AWS API Documentation

Request Syntax

client.batch_get_dev_endpoints(
    DevEndpointNames=[
        'string',
    ]
)

type DevEndpointNames:

list

param DevEndpointNames:

[REQUIRED]

The list of DevEndpoint names, which may be the names returned from the ListDevEndpoint operation.

(string) --

rtype:

dict

returns:

Response Syntax

{
    'DevEndpoints': [
        {
            'EndpointName': 'string',
            'RoleArn': 'string',
            'SecurityGroupIds': [
                'string',
            ],
            'SubnetId': 'string',
            'YarnEndpointAddress': 'string',
            'PrivateAddress': 'string',
            'ZeppelinRemoteSparkInterpreterPort': 123,
            'PublicAddress': 'string',
            'Status': 'string',
            'NumberOfNodes': 123,
            'AvailabilityZone': 'string',
            'VpcId': 'string',
            'ExtraPythonLibsS3Path': 'string',
            'ExtraJarsS3Path': 'string',
            'FailureReason': 'string',
            'LastUpdateStatus': 'string',
            'CreatedTimestamp': datetime(2015, 1, 1),
            'LastModifiedTimestamp': datetime(2015, 1, 1),
            'PublicKey': 'string',
            'PublicKeys': [
                'string',
            ],
            'SecurityConfiguration': 'string',
            'Arguments': {
                'string': 'string'
            }
        },
    ],
    'DevEndpointsNotFound': [
        'string',
    ]
}

Response Structure

(dict) --
- DevEndpoints (list) --
  
  A list of DevEndpoint definitions.
  - (dict) --
    
    A development endpoint where a developer can remotely debug ETL scripts.
    - EndpointName (string) --
      
      The name of the DevEndpoint.
    - RoleArn (string) --
      
      The AWS ARN of the IAM role used in this DevEndpoint.
    - SecurityGroupIds (list) --
      
      A list of security group identifiers used in this DevEndpoint.
      - (string) --
    - SubnetId (string) --
      
      The subnet ID for this DevEndpoint.
    - YarnEndpointAddress (string) --
      
      The YARN endpoint address used by this DevEndpoint.
    - PrivateAddress (string) --
      
      A private IP address to access the DevEndpoint within a VPC, if the DevEndpoint is created within one. The PrivateAddress field is present only when you create the DevEndpoint within your virtual private cloud (VPC).
    - ZeppelinRemoteSparkInterpreterPort (integer) --
      
      The Apache Zeppelin port for the remote Apache Spark interpreter.
    - PublicAddress (string) --
      
      The public IP address used by this DevEndpoint. The PublicAddress field is present only when you create a non-VPC (virtual private cloud) DevEndpoint.
    - Status (string) --
      
      The current status of this DevEndpoint.
    - NumberOfNodes (integer) --
      
      The number of AWS Glue Data Processing Units (DPUs) allocated to this DevEndpoint.
    - AvailabilityZone (string) --
      
      The AWS availability zone where this DevEndpoint is located.
    - VpcId (string) --
      
      The ID of the virtual private cloud (VPC) used by this DevEndpoint.
    - ExtraPythonLibsS3Path (string) --
      
      Path(s) to one or more Python libraries in an S3 bucket that should be loaded in your DevEndpoint. Multiple values must be complete paths separated by a comma.
      
      Please note that only pure Python libraries can currently be used on a DevEndpoint. Libraries that rely on C extensions, such as the pandas Python data analysis library, are not yet supported.
    - ExtraJarsS3Path (string) --
      
      Path to one or more Java Jars in an S3 bucket that should be loaded in your DevEndpoint.
      
      Please note that only pure Java/Scala libraries can currently be used on a DevEndpoint.
    - FailureReason (string) --
      
      The reason for a current failure in this DevEndpoint.
    - LastUpdateStatus (string) --
      
      The status of the last update.
    - CreatedTimestamp (datetime) --
      
      The point in time at which this DevEndpoint was created.
    - LastModifiedTimestamp (datetime) --
      
      The point in time at which this DevEndpoint was last modified.
    - PublicKey (string) --
      
      The public key to be used by this DevEndpoint for authentication. This attribute is provided for backward compatibility, as the recommended attribute to use is public keys.
    - PublicKeys (list) --
      
      A list of public keys to be used by the DevEndpoints for authentication. The use of this attribute is preferred over a single public key because the public keys allow you to have a different private key per client.
      
      Note
      
      If you previously created an endpoint with a public key, you must remove that key to be able to set a list of public keys: call the UpdateDevEndpoint API with the public key content in the deletePublicKeys attribute, and the list of new keys in the addPublicKeys attribute.
      - (string) --
    - SecurityConfiguration (string) --
      
      The name of the SecurityConfiguration structure to be used with this DevEndpoint.
    - Arguments (dict) --
      
      A map of arguments used to configure the DevEndpoint.
      
      Note that currently, we only support "--enable-glue-datacatalog": "" as a valid argument.
      - (string) --
        
        (string) --
- DevEndpointsNotFound (list) --
  
  A list of DevEndpoints not found.
  - (string) --

CreateDevEndpoint (updated)

Link ¶
Changes (both)

{'Arguments': {'string': 'string'}}

Creates a new DevEndpoint.

See also: AWS API Documentation

Request Syntax

client.create_dev_endpoint(
    EndpointName='string',
    RoleArn='string',
    SecurityGroupIds=[
        'string',
    ],
    SubnetId='string',
    PublicKey='string',
    PublicKeys=[
        'string',
    ],
    NumberOfNodes=123,
    ExtraPythonLibsS3Path='string',
    ExtraJarsS3Path='string',
    SecurityConfiguration='string',
    Tags={
        'string': 'string'
    },
    Arguments={
        'string': 'string'
    }
)

type EndpointName:

string

param EndpointName:

[REQUIRED]

The name to be assigned to the new DevEndpoint.

type RoleArn:

string

param RoleArn:

[REQUIRED]

The IAM role for the DevEndpoint.

type SecurityGroupIds:

list

param SecurityGroupIds:

Security group IDs for the security groups to be used by the new DevEndpoint.

(string) --

type SubnetId:

string

param SubnetId:

The subnet ID for the new DevEndpoint to use.

type PublicKey:

string

param PublicKey:

The public key to be used by this DevEndpoint for authentication. This attribute is provided for backward compatibility, as the recommended attribute to use is public keys.

type PublicKeys:

list

param PublicKeys:

A list of public keys to be used by the DevEndpoints for authentication. The use of this attribute is preferred over a single public key because the public keys allow you to have a different private key per client.

(string) --

type NumberOfNodes:

integer

param NumberOfNodes:

The number of AWS Glue Data Processing Units (DPUs) to allocate to this DevEndpoint.

type ExtraPythonLibsS3Path:

string

param ExtraPythonLibsS3Path:

Path(s) to one or more Python libraries in an S3 bucket that should be loaded in your DevEndpoint. Multiple values must be complete paths separated by a comma.

Please note that only pure Python libraries can currently be used on a DevEndpoint. Libraries that rely on C extensions, such as the pandas Python data analysis library, are not yet supported.

type ExtraJarsS3Path:

string

param ExtraJarsS3Path:

Path to one or more Java Jars in an S3 bucket that should be loaded in your DevEndpoint.

type SecurityConfiguration:

string

param SecurityConfiguration:

The name of the SecurityConfiguration structure to be used with this DevEndpoint.

type Tags:

dict

param Tags:

The tags to use with this DevEndpoint. You may use tags to limit access to the DevEndpoint. For more information about tags in AWS Glue, see AWS Tags in AWS Glue in the developer guide.

(string) --
- (string) --

type Arguments:

dict

param Arguments:

A map of arguments used to configure the DevEndpoint.

(string) --
- (string) --

rtype:

dict

returns:

Response Syntax

{
    'EndpointName': 'string',
    'Status': 'string',
    'SecurityGroupIds': [
        'string',
    ],
    'SubnetId': 'string',
    'RoleArn': 'string',
    'YarnEndpointAddress': 'string',
    'ZeppelinRemoteSparkInterpreterPort': 123,
    'NumberOfNodes': 123,
    'AvailabilityZone': 'string',
    'VpcId': 'string',
    'ExtraPythonLibsS3Path': 'string',
    'ExtraJarsS3Path': 'string',
    'FailureReason': 'string',
    'SecurityConfiguration': 'string',
    'CreatedTimestamp': datetime(2015, 1, 1),
    'Arguments': {
        'string': 'string'
    }
}

Response Structure

(dict) --
- EndpointName (string) --
  
  The name assigned to the new DevEndpoint.
- Status (string) --
  
  The current status of the new DevEndpoint.
- SecurityGroupIds (list) --
  
  The security groups assigned to the new DevEndpoint.
  - (string) --
- SubnetId (string) --
  
  The subnet ID assigned to the new DevEndpoint.
- RoleArn (string) --
  
  The AWS ARN of the role assigned to the new DevEndpoint.
- YarnEndpointAddress (string) --
  
  The address of the YARN endpoint used by this DevEndpoint.
- ZeppelinRemoteSparkInterpreterPort (integer) --
  
  The Apache Zeppelin port for the remote Apache Spark interpreter.
- NumberOfNodes (integer) --
  
  The number of AWS Glue Data Processing Units (DPUs) allocated to this DevEndpoint.
- AvailabilityZone (string) --
  
  The AWS availability zone where this DevEndpoint is located.
- VpcId (string) --
  
  The ID of the VPC used by this DevEndpoint.
- ExtraPythonLibsS3Path (string) --
  
  Path(s) to one or more Python libraries in an S3 bucket that will be loaded in your DevEndpoint.
- ExtraJarsS3Path (string) --
  
  Path to one or more Java Jars in an S3 bucket that will be loaded in your DevEndpoint.
- FailureReason (string) --
  
  The reason for a current failure in this DevEndpoint.
- SecurityConfiguration (string) --
  
  The name of the SecurityConfiguration structure being used with this DevEndpoint.
- CreatedTimestamp (datetime) --
  
  The point in time at which this DevEndpoint was created.
- Arguments (dict) --
  
  The map of arguments used to configure this DevEndpoint.
  - (string) --
    - (string) --

GetDevEndpoint (updated)

Link ¶
Changes (response)

{'DevEndpoint': {'Arguments': {'string': 'string'}}}

Retrieves information about a specified DevEndpoint.

See also: AWS API Documentation

Request Syntax

client.get_dev_endpoint(
    EndpointName='string'
)

type EndpointName:

string

param EndpointName:

[REQUIRED]

Name of the DevEndpoint for which to retrieve information.

rtype:

dict

returns:

Response Syntax

{
    'DevEndpoint': {
        'EndpointName': 'string',
        'RoleArn': 'string',
        'SecurityGroupIds': [
            'string',
        ],
        'SubnetId': 'string',
        'YarnEndpointAddress': 'string',
        'PrivateAddress': 'string',
        'ZeppelinRemoteSparkInterpreterPort': 123,
        'PublicAddress': 'string',
        'Status': 'string',
        'NumberOfNodes': 123,
        'AvailabilityZone': 'string',
        'VpcId': 'string',
        'ExtraPythonLibsS3Path': 'string',
        'ExtraJarsS3Path': 'string',
        'FailureReason': 'string',
        'LastUpdateStatus': 'string',
        'CreatedTimestamp': datetime(2015, 1, 1),
        'LastModifiedTimestamp': datetime(2015, 1, 1),
        'PublicKey': 'string',
        'PublicKeys': [
            'string',
        ],
        'SecurityConfiguration': 'string',
        'Arguments': {
            'string': 'string'
        }
    }
}

Response Structure

(dict) --
- DevEndpoint (dict) --
  
  A DevEndpoint definition.
  - EndpointName (string) --
    
    The name of the DevEndpoint.
  - RoleArn (string) --
    
    The AWS ARN of the IAM role used in this DevEndpoint.
  - SecurityGroupIds (list) --
    
    A list of security group identifiers used in this DevEndpoint.
    - (string) --
  - SubnetId (string) --
    
    The subnet ID for this DevEndpoint.
  - YarnEndpointAddress (string) --
    
    The YARN endpoint address used by this DevEndpoint.
  - PrivateAddress (string) --
    
    A private IP address to access the DevEndpoint within a VPC, if the DevEndpoint is created within one. The PrivateAddress field is present only when you create the DevEndpoint within your virtual private cloud (VPC).
  - ZeppelinRemoteSparkInterpreterPort (integer) --
    
    The Apache Zeppelin port for the remote Apache Spark interpreter.
  - PublicAddress (string) --
    
    The public IP address used by this DevEndpoint. The PublicAddress field is present only when you create a non-VPC (virtual private cloud) DevEndpoint.
  - Status (string) --
    
    The current status of this DevEndpoint.
  - NumberOfNodes (integer) --
    
    The number of AWS Glue Data Processing Units (DPUs) allocated to this DevEndpoint.
  - AvailabilityZone (string) --
    
    The AWS availability zone where this DevEndpoint is located.
  - VpcId (string) --
    
    The ID of the virtual private cloud (VPC) used by this DevEndpoint.
  - ExtraPythonLibsS3Path (string) --
    
    Path(s) to one or more Python libraries in an S3 bucket that should be loaded in your DevEndpoint. Multiple values must be complete paths separated by a comma.
    
    Please note that only pure Python libraries can currently be used on a DevEndpoint. Libraries that rely on C extensions, such as the pandas Python data analysis library, are not yet supported.
  - ExtraJarsS3Path (string) --
    
    Path to one or more Java Jars in an S3 bucket that should be loaded in your DevEndpoint.
    
    Please note that only pure Java/Scala libraries can currently be used on a DevEndpoint.
  - FailureReason (string) --
    
    The reason for a current failure in this DevEndpoint.
  - LastUpdateStatus (string) --
    
    The status of the last update.
  - CreatedTimestamp (datetime) --
    
    The point in time at which this DevEndpoint was created.
  - LastModifiedTimestamp (datetime) --
    
    The point in time at which this DevEndpoint was last modified.
  - PublicKey (string) --
    
    The public key to be used by this DevEndpoint for authentication. This attribute is provided for backward compatibility, as the recommended attribute to use is public keys.
  - PublicKeys (list) --
    
    A list of public keys to be used by the DevEndpoints for authentication. The use of this attribute is preferred over a single public key because the public keys allow you to have a different private key per client.
    
    Note
    
    If you previously created an endpoint with a public key, you must remove that key to be able to set a list of public keys: call the UpdateDevEndpoint API with the public key content in the deletePublicKeys attribute, and the list of new keys in the addPublicKeys attribute.
    - (string) --
  - SecurityConfiguration (string) --
    
    The name of the SecurityConfiguration structure to be used with this DevEndpoint.
  - Arguments (dict) --
    
    A map of arguments used to configure the DevEndpoint.
    
    Note that currently, we only support "--enable-glue-datacatalog": "" as a valid argument.
    - (string) --
      - (string) --

GetDevEndpoints (updated)

Link ¶
Changes (response)

{'DevEndpoints': {'Arguments': {'string': 'string'}}}

Retrieves all the DevEndpoints in this AWS account.

See also: AWS API Documentation

Request Syntax

client.get_dev_endpoints(
    MaxResults=123,
    NextToken='string'
)

type MaxResults:

integer

param MaxResults:

The maximum size of information to return.

type NextToken:

string

param NextToken:

A continuation token, if this is a continuation call.

rtype:

dict

returns:

Response Syntax

{
    'DevEndpoints': [
        {
            'EndpointName': 'string',
            'RoleArn': 'string',
            'SecurityGroupIds': [
                'string',
            ],
            'SubnetId': 'string',
            'YarnEndpointAddress': 'string',
            'PrivateAddress': 'string',
            'ZeppelinRemoteSparkInterpreterPort': 123,
            'PublicAddress': 'string',
            'Status': 'string',
            'NumberOfNodes': 123,
            'AvailabilityZone': 'string',
            'VpcId': 'string',
            'ExtraPythonLibsS3Path': 'string',
            'ExtraJarsS3Path': 'string',
            'FailureReason': 'string',
            'LastUpdateStatus': 'string',
            'CreatedTimestamp': datetime(2015, 1, 1),
            'LastModifiedTimestamp': datetime(2015, 1, 1),
            'PublicKey': 'string',
            'PublicKeys': [
                'string',
            ],
            'SecurityConfiguration': 'string',
            'Arguments': {
                'string': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) --
- DevEndpoints (list) --
  
  A list of DevEndpoint definitions.
  - (dict) --
    
    A development endpoint where a developer can remotely debug ETL scripts.
    - EndpointName (string) --
      
      The name of the DevEndpoint.
    - RoleArn (string) --
      
      The AWS ARN of the IAM role used in this DevEndpoint.
    - SecurityGroupIds (list) --
      
      A list of security group identifiers used in this DevEndpoint.
      - (string) --
    - SubnetId (string) --
      
      The subnet ID for this DevEndpoint.
    - YarnEndpointAddress (string) --
      
      The YARN endpoint address used by this DevEndpoint.
    - PrivateAddress (string) --
      
      A private IP address to access the DevEndpoint within a VPC, if the DevEndpoint is created within one. The PrivateAddress field is present only when you create the DevEndpoint within your virtual private cloud (VPC).
    - ZeppelinRemoteSparkInterpreterPort (integer) --
      
      The Apache Zeppelin port for the remote Apache Spark interpreter.
    - PublicAddress (string) --
      
      The public IP address used by this DevEndpoint. The PublicAddress field is present only when you create a non-VPC (virtual private cloud) DevEndpoint.
    - Status (string) --
      
      The current status of this DevEndpoint.
    - NumberOfNodes (integer) --
      
      The number of AWS Glue Data Processing Units (DPUs) allocated to this DevEndpoint.
    - AvailabilityZone (string) --
      
      The AWS availability zone where this DevEndpoint is located.
    - VpcId (string) --
      
      The ID of the virtual private cloud (VPC) used by this DevEndpoint.
    - ExtraPythonLibsS3Path (string) --
      
      Path(s) to one or more Python libraries in an S3 bucket that should be loaded in your DevEndpoint. Multiple values must be complete paths separated by a comma.
      
      Please note that only pure Python libraries can currently be used on a DevEndpoint. Libraries that rely on C extensions, such as the pandas Python data analysis library, are not yet supported.
    - ExtraJarsS3Path (string) --
      
      Path to one or more Java Jars in an S3 bucket that should be loaded in your DevEndpoint.
      
      Please note that only pure Java/Scala libraries can currently be used on a DevEndpoint.
    - FailureReason (string) --
      
      The reason for a current failure in this DevEndpoint.
    - LastUpdateStatus (string) --
      
      The status of the last update.
    - CreatedTimestamp (datetime) --
      
      The point in time at which this DevEndpoint was created.
    - LastModifiedTimestamp (datetime) --
      
      The point in time at which this DevEndpoint was last modified.
    - PublicKey (string) --
      
      The public key to be used by this DevEndpoint for authentication. This attribute is provided for backward compatibility, as the recommended attribute to use is public keys.
    - PublicKeys (list) --
      
      A list of public keys to be used by the DevEndpoints for authentication. The use of this attribute is preferred over a single public key because the public keys allow you to have a different private key per client.
      
      Note
      
      If you previously created an endpoint with a public key, you must remove that key to be able to set a list of public keys: call the UpdateDevEndpoint API with the public key content in the deletePublicKeys attribute, and the list of new keys in the addPublicKeys attribute.
      - (string) --
    - SecurityConfiguration (string) --
      
      The name of the SecurityConfiguration structure to be used with this DevEndpoint.
    - Arguments (dict) --
      
      A map of arguments used to configure the DevEndpoint.
      
      Note that currently, we only support "--enable-glue-datacatalog": "" as a valid argument.
      - (string) --
        
        (string) --
- NextToken (string) --
  
  A continuation token, if not all DevEndpoint definitions have yet been returned.

UpdateDevEndpoint (updated)

Link ¶
Changes (request)

{'AddArguments': {'string': 'string'}, 'DeleteArguments': ['string']}

Updates a specified DevEndpoint.

See also: AWS API Documentation

Request Syntax

client.update_dev_endpoint(
    EndpointName='string',
    PublicKey='string',
    AddPublicKeys=[
        'string',
    ],
    DeletePublicKeys=[
        'string',
    ],
    CustomLibraries={
        'ExtraPythonLibsS3Path': 'string',
        'ExtraJarsS3Path': 'string'
    },
    UpdateEtlLibraries=True|False,
    DeleteArguments=[
        'string',
    ],
    AddArguments={
        'string': 'string'
    }
)

type EndpointName:

string

param EndpointName:

[REQUIRED]

The name of the DevEndpoint to be updated.

type PublicKey:

string

param PublicKey:

The public key for the DevEndpoint to use.

type AddPublicKeys:

list

param AddPublicKeys:

The list of public keys for the DevEndpoint to use.

(string) --

type DeletePublicKeys:

list

param DeletePublicKeys:

The list of public keys to be deleted from the DevEndpoint.

(string) --

type CustomLibraries:

dict

param CustomLibraries:

Custom Python or Java libraries to be loaded in the DevEndpoint.

ExtraPythonLibsS3Path (string) --

Path(s) to one or more Python libraries in an S3 bucket that should be loaded in your DevEndpoint. Multiple values must be complete paths separated by a comma.

Please note that only pure Python libraries can currently be used on a DevEndpoint. Libraries that rely on C extensions, such as the pandas Python data analysis library, are not yet supported.
ExtraJarsS3Path (string) --

Path to one or more Java Jars in an S3 bucket that should be loaded in your DevEndpoint.

Please note that only pure Java/Scala libraries can currently be used on a DevEndpoint.

type UpdateEtlLibraries:

boolean

param UpdateEtlLibraries:

True if the list of custom libraries to be loaded in the development endpoint needs to be updated, or False otherwise.

type DeleteArguments:

list

param DeleteArguments:

The list of argument keys to be deleted from the map of arguments used to configure the DevEndpoint.

(string) --

type AddArguments:

dict

param AddArguments:

The map of arguments to add the map of arguments used to configure the DevEndpoint.

(string) --
- (string) --

rtype:

dict

returns:

Response Syntax

{}

Response Structure

(dict) --