DataZone / Client / update_environment

update_environment#

DataZone.Client.update_environment(**kwargs)#

Updates the specified environment in Amazon DataZone.

Request Syntax

response = client.update_environment(
    description='string',
    domainIdentifier='string',
    glossaryTerms=[
        'string',
    ],
    identifier='string',
    name='string'
)

Parameters:

description (string) – The description to be updated as part of the UpdateEnvironment action.
domainIdentifier (string) –
[REQUIRED]

The identifier of the domain in which the environment is to be updated.
glossaryTerms (list) –
The glossary terms to be updated as part of the UpdateEnvironment action.
- (string) –
identifier (string) –
[REQUIRED]

The identifier of the environment that is to be updated.
name (string) – The name to be updated as part of the UpdateEnvironment action.

Return type:

dict

Returns:

Response Syntax

{
    'awsAccountId': 'string',
    'awsAccountRegion': 'string',
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'deploymentProperties': {
        'endTimeoutMinutes': 123,
        'startTimeoutMinutes': 123
    },
    'description': 'string',
    'domainId': 'string',
    'environmentActions': [
        {
            'auth': 'IAM'|'HTTPS',
            'parameters': [
                {
                    'key': 'string',
                    'value': 'string'
                },
            ],
            'type': 'string'
        },
    ],
    'environmentBlueprintId': 'string',
    'environmentProfileId': 'string',
    'glossaryTerms': [
        'string',
    ],
    'id': 'string',
    'lastDeployment': {
        'deploymentId': 'string',
        'deploymentStatus': 'IN_PROGRESS'|'SUCCESSFUL'|'FAILED'|'PENDING_DEPLOYMENT',
        'deploymentType': 'CREATE'|'UPDATE'|'DELETE',
        'failureReason': {
            'code': 'string',
            'message': 'string'
        },
        'isDeploymentComplete': True|False,
        'messages': [
            'string',
        ]
    },
    'name': 'string',
    'projectId': 'string',
    'provider': 'string',
    'provisionedResources': [
        {
            'name': 'string',
            'provider': 'string',
            'type': 'string',
            'value': 'string'
        },
    ],
    'provisioningProperties': {
        'cloudFormation': {
            'templateUrl': 'string'
        }
    },
    'status': 'ACTIVE'|'CREATING'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'UPDATE_FAILED'|'DELETE_FAILED'|'VALIDATION_FAILED'|'SUSPENDED'|'DISABLED'|'EXPIRED'|'DELETED'|'INACCESSIBLE',
    'updatedAt': datetime(2015, 1, 1),
    'userParameters': [
        {
            'defaultValue': 'string',
            'description': 'string',
            'fieldType': 'string',
            'isEditable': True|False,
            'isOptional': True|False,
            'keyName': 'string'
        },
    ]
}

Response Structure

(dict) –
- awsAccountId (string) –
  
  The identifier of the Amazon Web Services account in which the environment is to be updated.
- awsAccountRegion (string) –
  
  The Amazon Web Services Region in which the environment is updated.
- createdAt (datetime) –
  
  The timestamp of when the environment was created.
- createdBy (string) –
  
  The Amazon DataZone user who created the environment.
- deploymentProperties (dict) –
  
  The deployment properties to be updated as part of the UpdateEnvironment action.
  - endTimeoutMinutes (integer) –
    
    The end timeout of the environment blueprint deployment.
  - startTimeoutMinutes (integer) –
    
    The start timeout of the environment blueprint deployment.
- description (string) –
  
  The description to be updated as part of the UpdateEnvironment action.
- domainId (string) –
  
  The identifier of the domain in which the environment is to be updated.
- environmentActions (list) –
  
  The environment actions to be updated as part of the UpdateEnvironment action.
  - (dict) –
    
    The configurable action of a Amazon DataZone environment.
    - auth (string) –
      
      The authentication type of a configurable action of a Amazon DataZone environment.
    - parameters (list) –
      
      The parameters of a configurable action in a Amazon DataZone environment.
      - (dict) –
        
        The details of the parameters for the configurable environment action.
        
        key (string) –
        
        The key of the configurable action parameter.
        
        value (string) –
        
        The value of the configurable action parameter.
    - type (string) –
      
      The type of a configurable action in a Amazon DataZone environment.
- environmentBlueprintId (string) –
  
  The blueprint identifier of the environment.
- environmentProfileId (string) –
  
  The profile identifier of the environment.
- glossaryTerms (list) –
  
  The glossary terms to be updated as part of the UpdateEnvironment action.
  - (string) –
- id (string) –
  
  The identifier of the environment that is to be updated.
- lastDeployment (dict) –
  
  The last deployment of the environment.
  - deploymentId (string) –
    
    The identifier of the last deployment of the environment.
  - deploymentStatus (string) –
    
    The status of the last deployment of the environment.
  - deploymentType (string) –
    
    The type of the last deployment of the environment.
  - failureReason (dict) –
    
    The failure reason of the last deployment of the environment.
    - code (string) –
      
      The error code for the failure reason for the environment deployment.
    - message (string) –
      
      The error message for the failure reason for the environment deployment.
  - isDeploymentComplete (boolean) –
    
    Specifies whether the last deployment of the environment is complete.
  - messages (list) –
    
    The messages of the last deployment of the environment.
    - (string) –
- name (string) –
  
  The name to be updated as part of the UpdateEnvironment action.
- projectId (string) –
  
  The project identifier of the environment.
- provider (string) –
  
  The provider identifier of the environment.
- provisionedResources (list) –
  
  The provisioned resources to be updated as part of the UpdateEnvironment action.
  - (dict) –
    
    The details of a provisioned resource of this Amazon DataZone environment.
    - name (string) –
      
      The name of a provisioned resource of this Amazon DataZone environment.
    - provider (string) –
      
      The provider of a provisioned resource of this Amazon DataZone environment.
    - type (string) –
      
      The type of a provisioned resource of this Amazon DataZone environment.
    - value (string) –
      
      The value of a provisioned resource of this Amazon DataZone environment.
- provisioningProperties (dict) –
  
  The provisioning properties to be updated as part of the UpdateEnvironment action.
  Note
  This is a Tagged Union structure. Only one of the following top level keys will be set: cloudFormation. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:
  'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
  - cloudFormation (dict) –
    
    The cloud formation properties included as part of the provisioning properties of an environment blueprint.
    - templateUrl (string) –
      
      The template URL of the cloud formation provisioning properties of the environment blueprint.
- status (string) –
  
  The status to be updated as part of the UpdateEnvironment action.
- updatedAt (datetime) –
  
  The timestamp of when the environment was updated.
- userParameters (list) –
  
  The user parameters to be updated as part of the UpdateEnvironment action.
  - (dict) –
    
    The details of user parameters of an environment blueprint.
    - defaultValue (string) –
      
      The default value of the parameter.
    - description (string) –
      
      The description of the parameter.
    - fieldType (string) –
      
      The filed type of the parameter.
    - isEditable (boolean) –
      
      Specifies whether the parameter is editable.
    - isOptional (boolean) –
      
      Specifies whether the custom parameter is optional.
    - keyName (string) –
      
      The key name of the parameter.

Exceptions

DataZone.Client.exceptions.InternalServerException
DataZone.Client.exceptions.AccessDeniedException
DataZone.Client.exceptions.ThrottlingException
DataZone.Client.exceptions.ServiceQuotaExceededException
DataZone.Client.exceptions.ConflictException
DataZone.Client.exceptions.ValidationException
DataZone.Client.exceptions.UnauthorizedException