BedrockAgentCoreControl / Client / create_consent_portal

create_consent_portal

BedrockAgentCoreControl.Client.create_consent_portal(**kwargs)

Creates a new consent portal.

See also: AWS API Documentation

Request Syntax

response = client.create_consent_portal(
    executionRoleArn='string',
    idpConfig={
        'credentialProviderArn': 'string',
        'scopes': [
            'string',
        ],
        'audience': 'string'
    },
    name='string',
    sources=[
        {
            'identifier': 'string',
            'type': 'agentcore-gateway'
        },
    ],
    description='string',
    tags={
        'string': 'string'
    }
)

Parameters:

• executionRoleArn (string) –

  [REQUIRED]

  The Amazon Resource Name (ARN) of the IAM role that the consent portal assumes to access the resources defined in its sources.

• idpConfig (dict) –

  [REQUIRED]

  The identity provider configuration that the consent portal uses to authenticate end users.

  • credentialProviderArn (string) – [REQUIRED]

    The Amazon Resource Name (ARN) of the OAuth2 credential provider used to authenticate end users to the consent portal.

  • scopes (list) – [REQUIRED]

    The OAuth2 scopes that the consent portal requests when authenticating end users.

    • (string) –

  • audience (string) –

    The audience value that the consent portal includes when requesting tokens from the identity provider.

• name (string) –

  [REQUIRED]

  The name of the consent portal. The name must be unique within your account.

• sources (list) –

  [REQUIRED]

  The resources served by the consent portal. Currently, we only support type agentcore-gateway.

  • (dict) –

    A resource served by the consent portal.

    • identifier (string) – [REQUIRED]

      The identifier of the source resource. For an agentcore-gateway source, this is the gateway ID or its Amazon Resource Name (ARN).

    • type (string) – [REQUIRED]

      The type of the source resource.

• description (string) – The description of the consent portal.

• tags (dict) –

  A map of tag keys and values to assign to the consent portal. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment.

  • (string) –

    • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'sources': [
        {
            'identifier': 'string',
            'type': 'agentcore-gateway'
        },
    ],
    'consentPortalArn': 'string',
    'consentPortalId': 'string',
    'createdAt': datetime(2015, 1, 1),
    'description': 'string',
    'executionRoleArn': 'string',
    'idpConfig': {
        'credentialProviderArn': 'string',
        'scopes': [
            'string',
        ],
        'audience': 'string'
    },
    'name': 'string',
    'portalUrl': 'string',
    'status': 'CREATING'|'ACTIVE'|'UPDATING'|'UPDATE_FAILED'|'DELETING'|'FAILED',
    'statusReason': 'string',
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

• (dict) –

  • sources (list) –

    The resources served by the consent portal.

    • (dict) –

      A resource served by the consent portal.

      • identifier (string) –

        The identifier of the source resource. For an agentcore-gateway source, this is the gateway ID or its Amazon Resource Name (ARN).

      • type (string) –

        The type of the source resource.

  • consentPortalArn (string) –

    The Amazon Resource Name (ARN) of the consent portal.

  • consentPortalId (string) –

    The unique identifier of the consent portal.

  • createdAt (datetime) –

    The timestamp for when the consent portal was created.

  • description (string) –

    The description of the consent portal.

  • executionRoleArn (string) –

    The Amazon Resource Name (ARN) of the IAM role that the consent portal assumes to access the resources defined in its sources.

  • idpConfig (dict) –

    The identity provider configuration that the consent portal uses to authenticate end users.

    • credentialProviderArn (string) –

      The Amazon Resource Name (ARN) of the OAuth2 credential provider used to authenticate end users to the consent portal.

    • scopes (list) –

      The OAuth2 scopes that the consent portal requests when authenticating end users.

      • (string) –

    • audience (string) –

      The audience value that the consent portal includes when requesting tokens from the identity provider.

  • name (string) –

    The name of the consent portal.

  • portalUrl (string) –

    The URL used to access the consent portal.

  • status (string) –

    The current status of the consent portal.

  • statusReason (string) –

    A message that provides additional information about the current status of the consent portal.

  • updatedAt (datetime) –

    The timestamp for when the consent portal was last updated.

Exceptions

• BedrockAgentCoreControl.Client.exceptions.ServiceQuotaExceededException

• BedrockAgentCoreControl.Client.exceptions.UnauthorizedException

• BedrockAgentCoreControl.Client.exceptions.ValidationException

• BedrockAgentCoreControl.Client.exceptions.ConflictException

• BedrockAgentCoreControl.Client.exceptions.AccessDeniedException

• BedrockAgentCoreControl.Client.exceptions.ResourceNotFoundException

• BedrockAgentCoreControl.Client.exceptions.ThrottlingException

• BedrockAgentCoreControl.Client.exceptions.InternalServerException