ServiceDiscovery / Client / get_operation

get_operation#

ServiceDiscovery.Client.get_operation(**kwargs)#

Gets information about any operation that returns an operation ID in the response, such as a CreateService request.

Note

To get a list of operations that match specified criteria, see ListOperations.

See also: AWS API Documentation

Request Syntax

response = client.get_operation(
    OperationId='string'
)
Parameters:

OperationId (string) –

[REQUIRED]

The ID of the operation that you want to get more information about.

Return type:

dict

Returns:

Response Syntax

{
    'Operation': {
        'Id': 'string',
        'Type': 'CREATE_NAMESPACE'|'DELETE_NAMESPACE'|'UPDATE_NAMESPACE'|'UPDATE_SERVICE'|'REGISTER_INSTANCE'|'DEREGISTER_INSTANCE',
        'Status': 'SUBMITTED'|'PENDING'|'SUCCESS'|'FAIL',
        'ErrorMessage': 'string',
        'ErrorCode': 'string',
        'CreateDate': datetime(2015, 1, 1),
        'UpdateDate': datetime(2015, 1, 1),
        'Targets': {
            'string': 'string'
        }
    }
}

Response Structure

  • (dict) –

    • Operation (dict) –

      A complex type that contains information about the operation.

      • Id (string) –

        The ID of the operation that you want to get information about.

      • Type (string) –

        The name of the operation that’s associated with the specified ID.

      • Status (string) –

        The status of the operation. Values include the following:

        SUBMITTED

        This is the initial state that occurs immediately after you submit a request.

        PENDING

        Cloud Map is performing the operation.

        SUCCESS

        The operation succeeded.

        FAIL

        The operation failed. For the failure reason, see ErrorMessage.

      • ErrorMessage (string) –

        If the value of Status is FAIL, the reason that the operation failed.

      • ErrorCode (string) –

        The code associated with ErrorMessage. Values for ErrorCode include the following:

        • ACCESS_DENIED

        • CANNOT_CREATE_HOSTED_ZONE

        • EXPIRED_TOKEN

        • HOSTED_ZONE_NOT_FOUND

        • INTERNAL_FAILURE

        • INVALID_CHANGE_BATCH

        • THROTTLED_REQUEST

      • CreateDate (datetime) –

        The date and time that the request was submitted, in Unix date/time format and Coordinated Universal Time (UTC). The value of CreateDate is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.

      • UpdateDate (datetime) –

        The date and time that the value of Status changed to the current value, in Unix date/time format and Coordinated Universal Time (UTC). The value of UpdateDate is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.

      • Targets (dict) –

        The name of the target entity that’s associated with the operation:

        NAMESPACE

        The namespace ID is returned in the ResourceId property.

        SERVICE

        The service ID is returned in the ResourceId property.

        INSTANCE

        The instance ID is returned in the ResourceId property.

        • (string) –

          • (string) –

Exceptions

  • ServiceDiscovery.Client.exceptions.InvalidInput

  • ServiceDiscovery.Client.exceptions.OperationNotFound

Examples

Example: Get operation result

response = client.get_operation(
    OperationId='gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd',
)

print(response)

Expected Output:

{
    'Operation': {
        'CreateDate': 1587055860.121,
        'Id': 'gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd',
        'Status': 'SUCCESS',
        'Targets': {
            'NAMESPACE': 'ns-ylexjili4cdxy3xm',
        },
        'Type': 'CREATE_NAMESPACE',
        'UpdateDate': 1587055900.469,
    },
    'ResponseMetadata': {
        '...': '...',
    },
}