Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

get_operation

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': {
        '...': '...',
    },
}