DevOpsAgentService / Client / create_agent_space

create_agent_space¶

DevOpsAgentService.Client.create_agent_space(**kwargs)¶

Creates a new AgentSpace with the specified name and description. Duplicate space names are allowed.

Request Syntax

response = client.create_agent_space(
    name='string',
    description='string',
    locale='string',
    kmsKeyArn='string',
    clientToken='string',
    tags={
        'string': 'string'
    }
)

Parameters:

name (string) –
[REQUIRED]

The name of the AgentSpace.
description (string) – The description of the AgentSpace.
locale (string) – The locale for the AgentSpace, which determines the language used in agent responses.
kmsKeyArn (string) – The ARN of the AWS Key Management Service (AWS KMS) customer managed key that’s used to encrypt resources.
clientToken (string) –
Client-provided token to ensure request idempotency. When the same token is provided in subsequent calls, the same response is returned within a 8-hour window.

This field is autopopulated if not provided.
tags (dict) –
Tags to add to the AgentSpace at creation time.
- (string) –
  
  Tag key string.
  - (string) –
    
    Tag value string.

Return type:

dict

Returns:

Response Syntax

{
    'agentSpace': {
        'name': 'string',
        'description': 'string',
        'locale': 'string',
        'createdAt': datetime(2015, 1, 1),
        'updatedAt': datetime(2015, 1, 1),
        'kmsKeyArn': 'string',
        'agentSpaceId': 'string'
    },
    'tags': {
        'string': 'string'
    }
}

Response Structure

(dict) –

Output containing the newly created AgentSpace.
- agentSpace (dict) –
  
  Represents a complete AgentSpace with all its properties, timestamps, encryption settings, and unique identifier.
  - name (string) –
    
    The name of the AgentSpace.
  - description (string) –
    
    The description of the AgentSpace.
  - locale (string) –
    
    The locale for the AgentSpace, which determines the language used in agent responses.
  - createdAt (datetime) –
    
    The timestamp when the resource was created.
  - updatedAt (datetime) –
    
    The timestamp when the resource was last updated.
  - kmsKeyArn (string) –
    
    The ARN of the AWS Key Management Service (AWS KMS) customer managed key that’s used to encrypt resources.
  - agentSpaceId (string) –
    
    The unique identifier of the AgentSpace
- tags (dict) –
  
  Tags associated with the created AgentSpace.
  - (string) –
    
    Tag key string.
    - (string) –
      
      Tag value string.

Exceptions

DevOpsAgentService.Client.exceptions.ValidationException
DevOpsAgentService.Client.exceptions.ContentSizeExceededException
DevOpsAgentService.Client.exceptions.ServiceQuotaExceededException
DevOpsAgentService.Client.exceptions.ConflictException
DevOpsAgentService.Client.exceptions.InternalServerException
DevOpsAgentService.Client.exceptions.AccessDeniedException
DevOpsAgentService.Client.exceptions.ThrottlingException
DevOpsAgentService.Client.exceptions.InvalidParameterException
DevOpsAgentService.Client.exceptions.ResourceNotFoundException