CreateAccountAssociation

$result = $client->createAccountAssociation([/* ... */]);
$promise = $client->createAccountAssociationAsync([/* ... */]);

Creates a new account association via the destination id.

Parameter Syntax

$result = $client->createAccountAssociation([
    'ClientToken' => '<string>',
    'ConnectorDestinationId' => '<string>', // REQUIRED
    'Description' => '<string>',
    'Name' => '<string>',
    'Tags' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'AccountAssociationId' => '<string>',
    'Arn' => '<string>',
    'AssociationState' => 'ASSOCIATION_IN_PROGRESS|ASSOCIATION_FAILED|ASSOCIATION_SUCCEEDED|ASSOCIATION_DELETING|REFRESH_TOKEN_EXPIRED',
    'OAuthAuthorizationUrl' => '<string>',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ConflictException:

There is a conflict with the request.

ServiceUnavailableException:

The service is temporarily unavailable.

ThrottlingException:

The rate exceeds the limit.

ResourceNotFoundException:

The specified resource does not exist.

CreateCloudConnector

$result = $client->createCloudConnector([/* ... */]);
$promise = $client->createCloudConnectorAsync([/* ... */]);

Creates a C2C (cloud-to-cloud) connector.

Parameter Syntax

$result = $client->createCloudConnector([
    'ClientToken' => '<string>',
    'Description' => '<string>',
    'EndpointConfig' => [ // REQUIRED
        'lambda' => [
            'arn' => '<string>', // REQUIRED
        ],
    ],
    'EndpointType' => 'LAMBDA',
    'Name' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'Id' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ConflictException:

There is a conflict with the request.

ThrottlingException:

The rate exceeds the limit.

Examples

Example 1: CreateCloudConnector happy path for TP Link

$result = $client->createCloudConnector([
    'ClientToken' => '1234567890',
    'EndpointConfig' => [
        'lambda' => [
            'arn' => 'arn:aws:lambda:us-east-1:111122223333:function:my-function:myVersion',
        ],
    ],
    'EndpointType' => 'LAMBDA',
    'Name' => 'Connector for TP Link Cloud',
]);

Result syntax:

[
    'Id' => 'TPLinkConnector1211',
]

Example 2: CreateCloudConnector happy path for Ring

$result = $client->createCloudConnector([
    'ClientToken' => '12312321',
    'EndpointConfig' => [
        'lambda' => [
            'arn' => 'arn:aws:lambda:us-east-1:111122223333:function:my-function:myVersion',
        ],
    ],
    'EndpointType' => 'LAMBDA',
    'Name' => 'Connector for Ring Cloud',
]);

Result syntax:

[
    'Id' => 'RingConnector1212',
]

Example 3: CreateCloudConnector error path for Ring connector which already exists

$result = $client->createCloudConnector([
    'ClientToken' => '1213123123',
    'EndpointConfig' => [
        'lambda' => [
            'arn' => 'arn:aws:lambda:us-east-1:111122223333:function:my-function:myVersion2',
        ],
    ],
    'EndpointType' => 'LAMBDA',
    'Name' => 'Connector for Ring Cloud',
]);

CreateConnectorDestination

$result = $client->createConnectorDestination([/* ... */]);
$promise = $client->createConnectorDestinationAsync([/* ... */]);

Create a connector destination for connecting a cloud-to-cloud (C2C) connector to the customer's Amazon Web Services account.

Parameter Syntax

$result = $client->createConnectorDestination([
    'AuthConfig' => [ // REQUIRED
        'oAuth' => [
            'authUrl' => '<string>', // REQUIRED
            'oAuthCompleteRedirectUrl' => '<string>',
            'proactiveRefreshTokenRenewal' => [
                'DaysBeforeRenewal' => <integer>,
                'enabled' => true || false,
            ],
            'scope' => '<string>',
            'tokenEndpointAuthenticationScheme' => 'HTTP_BASIC|REQUEST_BODY_CREDENTIALS', // REQUIRED
            'tokenUrl' => '<string>', // REQUIRED
        ],
    ],
    'AuthType' => 'OAUTH', // REQUIRED
    'ClientToken' => '<string>',
    'CloudConnectorId' => '<string>', // REQUIRED
    'Description' => '<string>',
    'Name' => '<string>',
    'SecretsManager' => [ // REQUIRED
        'arn' => '<string>', // REQUIRED
        'versionId' => '<string>', // REQUIRED
    ],
]);

Parameter Details

Result Syntax

[
    'Id' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ConflictException:

There is a conflict with the request.

ThrottlingException:

The rate exceeds the limit.

CreateCredentialLocker

$result = $client->createCredentialLocker([/* ... */]);
$promise = $client->createCredentialLockerAsync([/* ... */]);

Create a product credential locker. This operation will trigger the creation of all the manufacturing resources including the Wi-Fi setup key pair and device certificate.

Parameter Syntax

$result = $client->createCredentialLocker([
    'ClientToken' => '<string>',
    'Name' => '<string>',
    'Tags' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'Arn' => '<string>',
    'CreatedAt' => <DateTime>,
    'Id' => '<string>',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ServiceQuotaExceededException:

The service quota has been exceeded for this request.

ConflictException:

There is a conflict with the request.

ServiceUnavailableException:

The service is temporarily unavailable.

ThrottlingException:

The rate exceeds the limit.

CreateDestination

$result = $client->createDestination([/* ... */]);
$promise = $client->createDestinationAsync([/* ... */]);

Create a destination. IoT managed integrations uses the destination to determine where to deliver notifications for a device.

Parameter Syntax

$result = $client->createDestination([
    'ClientToken' => '<string>',
    'DeliveryDestinationArn' => '<string>', // REQUIRED
    'DeliveryDestinationType' => 'KINESIS', // REQUIRED
    'Description' => '<string>',
    'Name' => '<string>', // REQUIRED
    'RoleArn' => '<string>', // REQUIRED
    'Tags' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'Name' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ConflictException:

There is a conflict with the request.

ThrottlingException:

The rate exceeds the limit.

CreateEventLogConfiguration

$result = $client->createEventLogConfiguration([/* ... */]);
$promise = $client->createEventLogConfigurationAsync([/* ... */]);

Set the event log configuration for the account, resource type, or specific resource.

Parameter Syntax

$result = $client->createEventLogConfiguration([
    'ClientToken' => '<string>',
    'EventLogLevel' => 'DEBUG|ERROR|INFO|WARN', // REQUIRED
    'ResourceId' => '<string>',
    'ResourceType' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'Id' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ServiceQuotaExceededException:

The service quota has been exceeded for this request.

ConflictException:

There is a conflict with the request.

ThrottlingException:

The rate exceeds the limit.

CreateManagedThing

$result = $client->createManagedThing([/* ... */]);
$promise = $client->createManagedThingAsync([/* ... */]);

Creates a managed thing. A managed thing contains the device identifier, protocol supported, and capabilities of the device in a protocol-specific format.

Parameter Syntax

$result = $client->createManagedThing([
    'AuthenticationMaterial' => '<string>', // REQUIRED
    'AuthenticationMaterialType' => 'CUSTOM_PROTOCOL_QR_BAR_CODE|WIFI_SETUP_QR_BAR_CODE|ZWAVE_QR_BAR_CODE|ZIGBEE_QR_BAR_CODE|DISCOVERED_DEVICE', // REQUIRED
    'Brand' => '<string>',
    'Capabilities' => '<string>',
    'CapabilityReport' => [
        'endpoints' => [ // REQUIRED
            [
                'capabilities' => [ // REQUIRED
                    [
                        'actions' => ['<string>', ...], // REQUIRED
                        'events' => ['<string>', ...], // REQUIRED
                        'id' => '<string>', // REQUIRED
                        'name' => '<string>', // REQUIRED
                        'properties' => ['<string>', ...], // REQUIRED
                        'version' => '<string>', // REQUIRED
                    ],
                    // ...
                ],
                'deviceTypes' => ['<string>', ...], // REQUIRED
                'id' => '<string>', // REQUIRED
            ],
            // ...
        ],
        'nodeId' => '<string>',
        'version' => '<string>', // REQUIRED
    ],
    'CapabilitySchemas' => [
        [
            'CapabilityId' => '<string>', // REQUIRED
            'ExtrinsicId' => '<string>', // REQUIRED
            'ExtrinsicVersion' => <integer>, // REQUIRED
            'Format' => 'AWS|ZCL|CONNECTOR', // REQUIRED
            'Schema' => [ // REQUIRED
            ],
        ],
        // ...
    ],
    'Classification' => '<string>',
    'ClientToken' => '<string>',
    'CredentialLockerId' => '<string>',
    'MetaData' => ['<string>', ...],
    'Model' => '<string>',
    'Name' => '<string>',
    'Owner' => '<string>',
    'Role' => 'CONTROLLER|DEVICE', // REQUIRED
    'SerialNumber' => '<string>',
    'Tags' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'Arn' => '<string>',
    'CreatedAt' => <DateTime>,
    'Id' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ConflictException:

There is a conflict with the request.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

CreateNotificationConfiguration

$result = $client->createNotificationConfiguration([/* ... */]);
$promise = $client->createNotificationConfigurationAsync([/* ... */]);

Creates a notification configuration. A configuration is a connection between an event type and a destination that you have already created.

Parameter Syntax

$result = $client->createNotificationConfiguration([
    'ClientToken' => '<string>',
    'DestinationName' => '<string>', // REQUIRED
    'EventType' => 'DEVICE_COMMAND|DEVICE_COMMAND_REQUEST|DEVICE_DISCOVERY_STATUS|DEVICE_EVENT|DEVICE_LIFE_CYCLE|DEVICE_STATE|DEVICE_OTA|CONNECTOR_ASSOCIATION|ACCOUNT_ASSOCIATION|CONNECTOR_ERROR_REPORT', // REQUIRED
    'Tags' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'EventType' => 'DEVICE_COMMAND|DEVICE_COMMAND_REQUEST|DEVICE_DISCOVERY_STATUS|DEVICE_EVENT|DEVICE_LIFE_CYCLE|DEVICE_STATE|DEVICE_OTA|CONNECTOR_ASSOCIATION|ACCOUNT_ASSOCIATION|CONNECTOR_ERROR_REPORT',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ConflictException:

There is a conflict with the request.

ThrottlingException:

The rate exceeds the limit.

CreateOtaTask

$result = $client->createOtaTask([/* ... */]);
$promise = $client->createOtaTaskAsync([/* ... */]);

Create an over-the-air (OTA) task to update a device.

Parameter Syntax

$result = $client->createOtaTask([
    'ClientToken' => '<string>',
    'Description' => '<string>',
    'OtaMechanism' => 'PUSH',
    'OtaSchedulingConfig' => [
        'EndBehavior' => 'STOP_ROLLOUT|CANCEL|FORCE_CANCEL',
        'EndTime' => '<string>',
        'MaintenanceWindows' => [
            [
                'DurationInMinutes' => <integer>,
                'StartTime' => '<string>',
            ],
            // ...
        ],
        'StartTime' => '<string>',
    ],
    'OtaTargetQueryString' => '<string>',
    'OtaTaskExecutionRetryConfig' => [
        'RetryConfigCriteria' => [
            [
                'FailureType' => 'FAILED|TIMED_OUT|ALL',
                'MinNumberOfRetries' => <integer>,
            ],
            // ...
        ],
    ],
    'OtaType' => 'ONE_TIME|CONTINUOUS', // REQUIRED
    'Protocol' => 'HTTP',
    'S3Url' => '<string>', // REQUIRED
    'Tags' => ['<string>', ...],
    'Target' => ['<string>', ...],
    'TaskConfigurationId' => '<string>',
]);

Parameter Details

Result Syntax

[
    'Description' => '<string>',
    'TaskArn' => '<string>',
    'TaskId' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ConflictException:

There is a conflict with the request.

ThrottlingException:

The rate exceeds the limit.

ResourceNotFoundException:

The specified resource does not exist.

CreateOtaTaskConfiguration

$result = $client->createOtaTaskConfiguration([/* ... */]);
$promise = $client->createOtaTaskConfigurationAsync([/* ... */]);

Create a configuraiton for the over-the-air (OTA) task.

Parameter Syntax

$result = $client->createOtaTaskConfiguration([
    'ClientToken' => '<string>',
    'Description' => '<string>',
    'Name' => '<string>',
    'PushConfig' => [
        'AbortConfig' => [
            'AbortConfigCriteriaList' => [
                [
                    'Action' => 'CANCEL',
                    'FailureType' => 'FAILED|REJECTED|TIMED_OUT|ALL',
                    'MinNumberOfExecutedThings' => <integer>,
                    'ThresholdPercentage' => <float>,
                ],
                // ...
            ],
        ],
        'RolloutConfig' => [
            'ExponentialRolloutRate' => [
                'BaseRatePerMinute' => <integer>,
                'IncrementFactor' => <float>,
                'RateIncreaseCriteria' => [
                    'numberOfNotifiedThings' => <integer>,
                    'numberOfSucceededThings' => <integer>,
                ],
            ],
            'MaximumPerMinute' => <integer>,
        ],
        'TimeoutConfig' => [
            'InProgressTimeoutInMinutes' => <integer>,
        ],
    ],
]);

Parameter Details

Result Syntax

[
    'TaskConfigurationId' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ConflictException:

There is a conflict with the request.

ThrottlingException:

The rate exceeds the limit.

CreateProvisioningProfile

$result = $client->createProvisioningProfile([/* ... */]);
$promise = $client->createProvisioningProfileAsync([/* ... */]);

Create a provisioning profile for a device to execute the provisioning flows using a provisioning template. The provisioning template is a document that defines the set of resources and policies applied to a device during the provisioning process.

Parameter Syntax

$result = $client->createProvisioningProfile([
    'CaCertificate' => '<string>',
    'ClientToken' => '<string>',
    'Name' => '<string>',
    'ProvisioningType' => 'FLEET_PROVISIONING|JITR', // REQUIRED
    'Tags' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'Arn' => '<string>',
    'ClaimCertificate' => '<string>',
    'ClaimCertificatePrivateKey' => '<string>',
    'Id' => '<string>',
    'Name' => '<string>',
    'ProvisioningType' => 'FLEET_PROVISIONING|JITR',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ConflictException:

There is a conflict with the request.

ServiceUnavailableException:

The service is temporarily unavailable.

ThrottlingException:

The rate exceeds the limit.

ResourceNotFoundException:

The specified resource does not exist.

DeleteAccountAssociation

$result = $client->deleteAccountAssociation([/* ... */]);
$promise = $client->deleteAccountAssociationAsync([/* ... */]);

Remove a third party account and related devices from an end user.

Parameter Syntax

$result = $client->deleteAccountAssociation([
    'AccountAssociationId' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

DeleteCloudConnector

$result = $client->deleteCloudConnector([/* ... */]);
$promise = $client->deleteCloudConnectorAsync([/* ... */]);

Delete a cloud connector.

Parameter Syntax

$result = $client->deleteCloudConnector([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

DeleteConnectorDestination

$result = $client->deleteConnectorDestination([/* ... */]);
$promise = $client->deleteConnectorDestinationAsync([/* ... */]);

Delete a connector destination for connecting a cloud-to-cloud (C2C) connector to the customer's Amazon Web Services account.

Parameter Syntax

$result = $client->deleteConnectorDestination([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

DeleteCredentialLocker

$result = $client->deleteCredentialLocker([/* ... */]);
$promise = $client->deleteCredentialLockerAsync([/* ... */]);

Delete a credential locker.

Parameter Syntax

$result = $client->deleteCredentialLocker([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

DeleteDestination

$result = $client->deleteDestination([/* ... */]);
$promise = $client->deleteDestinationAsync([/* ... */]);

Deletes a customer-managed destination specified by id.

Parameter Syntax

$result = $client->deleteDestination([
    'Name' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

DeleteEventLogConfiguration

$result = $client->deleteEventLogConfiguration([/* ... */]);
$promise = $client->deleteEventLogConfigurationAsync([/* ... */]);

Delete an event log configuration.

Parameter Syntax

$result = $client->deleteEventLogConfiguration([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

DeleteManagedThing

$result = $client->deleteManagedThing([/* ... */]);
$promise = $client->deleteManagedThingAsync([/* ... */]);

Delete a managed thing. If a controller is deleted, all of the devices connected to it will have their status changed to PENDING. It is not possible to remove a cloud device.

Parameter Syntax

$result = $client->deleteManagedThing([
    'Force' => true || false,
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ConflictException:

There is a conflict with the request.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

DeleteNotificationConfiguration

$result = $client->deleteNotificationConfiguration([/* ... */]);
$promise = $client->deleteNotificationConfigurationAsync([/* ... */]);

Deletes a notification configuration.

Parameter Syntax

$result = $client->deleteNotificationConfiguration([
    'EventType' => 'DEVICE_COMMAND|DEVICE_COMMAND_REQUEST|DEVICE_DISCOVERY_STATUS|DEVICE_EVENT|DEVICE_LIFE_CYCLE|DEVICE_STATE|DEVICE_OTA|CONNECTOR_ASSOCIATION|ACCOUNT_ASSOCIATION|CONNECTOR_ERROR_REPORT', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

DeleteOtaTask

$result = $client->deleteOtaTask([/* ... */]);
$promise = $client->deleteOtaTaskAsync([/* ... */]);

Delete the over-the-air (OTA) task.

Parameter Syntax

$result = $client->deleteOtaTask([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

LimitExceededException:

The request exceeds a service limit or quota. Adjust your request parameters and try again.

DeleteOtaTaskConfiguration

$result = $client->deleteOtaTaskConfiguration([/* ... */]);
$promise = $client->deleteOtaTaskConfigurationAsync([/* ... */]);

Delete the over-the-air (OTA) task configuration.

Parameter Syntax

$result = $client->deleteOtaTaskConfiguration([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

DeleteProvisioningProfile

$result = $client->deleteProvisioningProfile([/* ... */]);
$promise = $client->deleteProvisioningProfileAsync([/* ... */]);

Delete a provisioning profile.

Parameter Syntax

$result = $client->deleteProvisioningProfile([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

DeregisterAccountAssociation

$result = $client->deregisterAccountAssociation([/* ... */]);
$promise = $client->deregisterAccountAssociationAsync([/* ... */]);

Deregisters an account association, removing the connection between a managed thing and a third-party account.

Parameter Syntax

$result = $client->deregisterAccountAssociation([
    'AccountAssociationId' => '<string>', // REQUIRED
    'ManagedThingId' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ThrottlingException:

The rate exceeds the limit.

ResourceNotFoundException:

The specified resource does not exist.

GetAccountAssociation

$result = $client->getAccountAssociation([/* ... */]);
$promise = $client->getAccountAssociationAsync([/* ... */]);

Get an account association for an Amazon Web Services account linked to a customer-managed destination.

Parameter Syntax

$result = $client->getAccountAssociation([
    'AccountAssociationId' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'AccountAssociationId' => '<string>',
    'Arn' => '<string>',
    'AssociationState' => 'ASSOCIATION_IN_PROGRESS|ASSOCIATION_FAILED|ASSOCIATION_SUCCEEDED|ASSOCIATION_DELETING|REFRESH_TOKEN_EXPIRED',
    'ConnectorDestinationId' => '<string>',
    'Description' => '<string>',
    'ErrorMessage' => '<string>',
    'Name' => '<string>',
    'OAuthAuthorizationUrl' => '<string>',
    'Tags' => ['<string>', ...],
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetCloudConnector

$result = $client->getCloudConnector([/* ... */]);
$promise = $client->getCloudConnectorAsync([/* ... */]);

Gets all the information about a connector for a connector developer.

Parameter Syntax

$result = $client->getCloudConnector([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'Description' => '<string>',
    'EndpointConfig' => [
        'lambda' => [
            'arn' => '<string>',
        ],
    ],
    'EndpointType' => 'LAMBDA',
    'Id' => '<string>',
    'Name' => '<string>',
    'Type' => 'LISTED|UNLISTED',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

Examples

Example 1: GetCloudConnector happy path for TP Link to get connector resource

$result = $client->getCloudConnector([
    'Identifier' => '123456789012',
]);

Result syntax:

[
    'EndpointConfig' => [
        'lambda' => [
            'arn' => 'arn:aws:lambda:us-east-1:111122223333:function:my-function:myVersion',
        ],
    ],
    'EndpointType' => 'LAMBDA',
    'Id' => '123456789012',
    'Name' => 'Connector for TP Link Cloud V2',
]

Example 2: GetCloudConnector happy path for Ring to pending status

$result = $client->getCloudConnector([
    'Identifier' => '123456789012',
]);

Result syntax:

[
    'EndpointConfig' => [
        'lambda' => [
            'arn' => 'arn:aws:lambda:us-east-1:111122223333:function:my-function:myVersion',
        ],
    ],
    'Name' => 'Connector for Ring Cloud',
]

Example 3: GetCloudConnector error Id for Ring connector which does not exist

$result = $client->getCloudConnector([
    'Identifier' => '123456789012',
]);

GetConnectorDestination

$result = $client->getConnectorDestination([/* ... */]);
$promise = $client->getConnectorDestinationAsync([/* ... */]);

Get a connector destination of a cloud-to-cloud (C2C) connector connecting to a customer's Amazon Web Services account.

Parameter Syntax

$result = $client->getConnectorDestination([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'AuthConfig' => [
        'oAuth' => [
            'authUrl' => '<string>',
            'oAuthCompleteRedirectUrl' => '<string>',
            'proactiveRefreshTokenRenewal' => [
                'DaysBeforeRenewal' => <integer>,
                'enabled' => true || false,
            ],
            'scope' => '<string>',
            'tokenEndpointAuthenticationScheme' => 'HTTP_BASIC|REQUEST_BODY_CREDENTIALS',
            'tokenUrl' => '<string>',
        ],
    ],
    'AuthType' => 'OAUTH',
    'CloudConnectorId' => '<string>',
    'Description' => '<string>',
    'Id' => '<string>',
    'Name' => '<string>',
    'OAuthCompleteRedirectUrl' => '<string>',
    'SecretsManager' => [
        'arn' => '<string>',
        'versionId' => '<string>',
    ],
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetCredentialLocker

$result = $client->getCredentialLocker([/* ... */]);
$promise = $client->getCredentialLockerAsync([/* ... */]);

Get information on an existing credential locker

Parameter Syntax

$result = $client->getCredentialLocker([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'Arn' => '<string>',
    'CreatedAt' => <DateTime>,
    'Id' => '<string>',
    'Name' => '<string>',
    'Tags' => ['<string>', ...],
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetCustomEndpoint

$result = $client->getCustomEndpoint([/* ... */]);
$promise = $client->getCustomEndpointAsync([/* ... */]);

Returns the IoT managed integrations custom endpoint.

Parameter Syntax

$result = $client->getCustomEndpoint([
]);

Parameter Details

Result Syntax

[
    'EndpointAddress' => '<string>',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetDefaultEncryptionConfiguration

$result = $client->getDefaultEncryptionConfiguration([/* ... */]);
$promise = $client->getDefaultEncryptionConfigurationAsync([/* ... */]);

Retrieves information about the default encryption configuration for the Amazon Web Services account in the default or specified region. For more information, see Key management in the AWS IoT SiteWise User Guide.

Parameter Syntax

$result = $client->getDefaultEncryptionConfiguration([
]);

Parameter Details

Result Syntax

[
    'configurationStatus' => [
        'error' => [
            'code' => '<string>',
            'message' => '<string>',
        ],
        'state' => 'ENABLED|UPDATE_IN_PROGRESS|UPDATE_FAILED',
    ],
    'encryptionType' => 'MANAGED_INTEGRATIONS_DEFAULT_ENCRYPTION|CUSTOMER_KEY_ENCRYPTION',
    'kmsKeyArn' => '<string>',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalFailureException:

An unexpected error has occurred.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetDestination

$result = $client->getDestination([/* ... */]);
$promise = $client->getDestinationAsync([/* ... */]);

Gets a destination by ID.

Parameter Syntax

$result = $client->getDestination([
    'Name' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'CreatedAt' => <DateTime>,
    'DeliveryDestinationArn' => '<string>',
    'DeliveryDestinationType' => 'KINESIS',
    'Description' => '<string>',
    'Name' => '<string>',
    'RoleArn' => '<string>',
    'Tags' => ['<string>', ...],
    'UpdatedAt' => <DateTime>,
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetDeviceDiscovery

$result = $client->getDeviceDiscovery([/* ... */]);
$promise = $client->getDeviceDiscoveryAsync([/* ... */]);

Get the current state of a device discovery.

Parameter Syntax

$result = $client->getDeviceDiscovery([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'AccountAssociationId' => '<string>',
    'Arn' => '<string>',
    'ConnectorAssociationId' => '<string>',
    'ControllerId' => '<string>',
    'DiscoveryType' => 'ZWAVE|ZIGBEE|CLOUD|CUSTOM',
    'FinishedAt' => <DateTime>,
    'Id' => '<string>',
    'StartedAt' => <DateTime>,
    'Status' => 'RUNNING|SUCCEEDED|FAILED|TIMED_OUT',
    'Tags' => ['<string>', ...],
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetEventLogConfiguration

$result = $client->getEventLogConfiguration([/* ... */]);
$promise = $client->getEventLogConfigurationAsync([/* ... */]);

Get an event log configuration.

Parameter Syntax

$result = $client->getEventLogConfiguration([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'EventLogLevel' => 'DEBUG|ERROR|INFO|WARN',
    'Id' => '<string>',
    'ResourceId' => '<string>',
    'ResourceType' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetHubConfiguration

$result = $client->getHubConfiguration([/* ... */]);
$promise = $client->getHubConfigurationAsync([/* ... */]);

Get a hub configuration.

Parameter Syntax

$result = $client->getHubConfiguration([
]);

Parameter Details

Result Syntax

[
    'HubTokenTimerExpirySettingInSeconds' => <integer>,
    'UpdatedAt' => <DateTime>,
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetManagedThing

$result = $client->getManagedThing([/* ... */]);
$promise = $client->getManagedThingAsync([/* ... */]);

Get the attributes and capabilities associated with a managed thing.

Parameter Syntax

$result = $client->getManagedThing([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'ActivatedAt' => <DateTime>,
    'AdvertisedProductId' => '<string>',
    'Arn' => '<string>',
    'Brand' => '<string>',
    'Classification' => '<string>',
    'ConnectorDestinationId' => '<string>',
    'ConnectorDeviceId' => '<string>',
    'ConnectorPolicyId' => '<string>',
    'CreatedAt' => <DateTime>,
    'CredentialLockerId' => '<string>',
    'DeviceSpecificKey' => '<string>',
    'HubNetworkMode' => 'STANDARD|NETWORK_WIDE_EXCLUSION',
    'Id' => '<string>',
    'InternationalArticleNumber' => '<string>',
    'MacAddress' => '<string>',
    'MetaData' => ['<string>', ...],
    'Model' => '<string>',
    'Name' => '<string>',
    'Owner' => '<string>',
    'ParentControllerId' => '<string>',
    'ProvisioningStatus' => 'UNASSOCIATED|PRE_ASSOCIATED|DISCOVERED|ACTIVATED|DELETION_FAILED|DELETE_IN_PROGRESS|ISOLATED|DELETED',
    'Role' => 'CONTROLLER|DEVICE',
    'SerialNumber' => '<string>',
    'Tags' => ['<string>', ...],
    'UniversalProductCode' => '<string>',
    'UpdatedAt' => <DateTime>,
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetManagedThingCapabilities

$result = $client->getManagedThingCapabilities([/* ... */]);
$promise = $client->getManagedThingCapabilitiesAsync([/* ... */]);

Get the capabilities for a managed thing using the device ID.

Parameter Syntax

$result = $client->getManagedThingCapabilities([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'Capabilities' => '<string>',
    'CapabilityReport' => [
        'endpoints' => [
            [
                'capabilities' => [
                    [
                        'actions' => ['<string>', ...],
                        'events' => ['<string>', ...],
                        'id' => '<string>',
                        'name' => '<string>',
                        'properties' => ['<string>', ...],
                        'version' => '<string>',
                    ],
                    // ...
                ],
                'deviceTypes' => ['<string>', ...],
                'id' => '<string>',
            ],
            // ...
        ],
        'nodeId' => '<string>',
        'version' => '<string>',
    ],
    'ManagedThingId' => '<string>',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetManagedThingConnectivityData

$result = $client->getManagedThingConnectivityData([/* ... */]);
$promise = $client->getManagedThingConnectivityDataAsync([/* ... */]);

Get the connectivity status of a managed thing.

Parameter Syntax

$result = $client->getManagedThingConnectivityData([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'Connected' => true || false,
    'DisconnectReason' => 'AUTH_ERROR|CLIENT_INITIATED_DISCONNECT|CLIENT_ERROR|CONNECTION_LOST|DUPLICATE_CLIENTID|FORBIDDEN_ACCESS|MQTT_KEEP_ALIVE_TIMEOUT|SERVER_ERROR|SERVER_INITIATED_DISCONNECT|THROTTLED|WEBSOCKET_TTL_EXPIRATION|CUSTOMAUTH_TTL_EXPIRATION|UNKNOWN|NONE',
    'ManagedThingId' => '<string>',
    'Timestamp' => <DateTime>,
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetManagedThingMetaData

$result = $client->getManagedThingMetaData([/* ... */]);
$promise = $client->getManagedThingMetaDataAsync([/* ... */]);

Get the metadata information for a managed thing.

Parameter Syntax

$result = $client->getManagedThingMetaData([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'ManagedThingId' => '<string>',
    'MetaData' => ['<string>', ...],
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetManagedThingState

$result = $client->getManagedThingState([/* ... */]);
$promise = $client->getManagedThingStateAsync([/* ... */]);

Returns the managed thing state for the given device Id.

Parameter Syntax

$result = $client->getManagedThingState([
    'ManagedThingId' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'Endpoints' => [
        [
            'capabilities' => [
                [
                    'id' => '<string>',
                    'name' => '<string>',
                    'properties' => [
                    ],
                    'version' => '<string>',
                ],
                // ...
            ],
            'endpointId' => '<string>',
        ],
        // ...
    ],
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalFailureException:

An unexpected error has occurred.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetNotificationConfiguration

$result = $client->getNotificationConfiguration([/* ... */]);
$promise = $client->getNotificationConfigurationAsync([/* ... */]);

Get a notification configuration.

Parameter Syntax

$result = $client->getNotificationConfiguration([
    'EventType' => 'DEVICE_COMMAND|DEVICE_COMMAND_REQUEST|DEVICE_DISCOVERY_STATUS|DEVICE_EVENT|DEVICE_LIFE_CYCLE|DEVICE_STATE|DEVICE_OTA|CONNECTOR_ASSOCIATION|ACCOUNT_ASSOCIATION|CONNECTOR_ERROR_REPORT', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'CreatedAt' => <DateTime>,
    'DestinationName' => '<string>',
    'EventType' => 'DEVICE_COMMAND|DEVICE_COMMAND_REQUEST|DEVICE_DISCOVERY_STATUS|DEVICE_EVENT|DEVICE_LIFE_CYCLE|DEVICE_STATE|DEVICE_OTA|CONNECTOR_ASSOCIATION|ACCOUNT_ASSOCIATION|CONNECTOR_ERROR_REPORT',
    'Tags' => ['<string>', ...],
    'UpdatedAt' => <DateTime>,
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetOtaTask

$result = $client->getOtaTask([/* ... */]);
$promise = $client->getOtaTaskAsync([/* ... */]);

Get the over-the-air (OTA) task.

Parameter Syntax

$result = $client->getOtaTask([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'CreatedAt' => <DateTime>,
    'Description' => '<string>',
    'LastUpdatedAt' => <DateTime>,
    'OtaMechanism' => 'PUSH',
    'OtaSchedulingConfig' => [
        'EndBehavior' => 'STOP_ROLLOUT|CANCEL|FORCE_CANCEL',
        'EndTime' => '<string>',
        'MaintenanceWindows' => [
            [
                'DurationInMinutes' => <integer>,
                'StartTime' => '<string>',
            ],
            // ...
        ],
        'StartTime' => '<string>',
    ],
    'OtaTargetQueryString' => '<string>',
    'OtaTaskExecutionRetryConfig' => [
        'RetryConfigCriteria' => [
            [
                'FailureType' => 'FAILED|TIMED_OUT|ALL',
                'MinNumberOfRetries' => <integer>,
            ],
            // ...
        ],
    ],
    'OtaType' => 'ONE_TIME|CONTINUOUS',
    'Protocol' => 'HTTP',
    'S3Url' => '<string>',
    'Status' => 'IN_PROGRESS|CANCELED|COMPLETED|DELETION_IN_PROGRESS|SCHEDULED',
    'Tags' => ['<string>', ...],
    'Target' => ['<string>', ...],
    'TaskArn' => '<string>',
    'TaskConfigurationId' => '<string>',
    'TaskId' => '<string>',
    'TaskProcessingDetails' => [
        'NumberOfCanceledThings' => <integer>,
        'NumberOfFailedThings' => <integer>,
        'NumberOfInProgressThings' => <integer>,
        'numberOfQueuedThings' => <integer>,
        'numberOfRejectedThings' => <integer>,
        'numberOfRemovedThings' => <integer>,
        'numberOfSucceededThings' => <integer>,
        'numberOfTimedOutThings' => <integer>,
        'processingTargets' => ['<string>', ...],
    ],
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetOtaTaskConfiguration

$result = $client->getOtaTaskConfiguration([/* ... */]);
$promise = $client->getOtaTaskConfigurationAsync([/* ... */]);

Get a configuraiton for the over-the-air (OTA) task.

Parameter Syntax

$result = $client->getOtaTaskConfiguration([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'CreatedAt' => <DateTime>,
    'Description' => '<string>',
    'Name' => '<string>',
    'PushConfig' => [
        'AbortConfig' => [
            'AbortConfigCriteriaList' => [
                [
                    'Action' => 'CANCEL',
                    'FailureType' => 'FAILED|REJECTED|TIMED_OUT|ALL',
                    'MinNumberOfExecutedThings' => <integer>,
                    'ThresholdPercentage' => <float>,
                ],
                // ...
            ],
        ],
        'RolloutConfig' => [
            'ExponentialRolloutRate' => [
                'BaseRatePerMinute' => <integer>,
                'IncrementFactor' => <float>,
                'RateIncreaseCriteria' => [
                    'numberOfNotifiedThings' => <integer>,
                    'numberOfSucceededThings' => <integer>,
                ],
            ],
            'MaximumPerMinute' => <integer>,
        ],
        'TimeoutConfig' => [
            'InProgressTimeoutInMinutes' => <integer>,
        ],
    ],
    'TaskConfigurationId' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetProvisioningProfile

$result = $client->getProvisioningProfile([/* ... */]);
$promise = $client->getProvisioningProfileAsync([/* ... */]);

Get a provisioning profile by template name.

Parameter Syntax

$result = $client->getProvisioningProfile([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'Arn' => '<string>',
    'ClaimCertificate' => '<string>',
    'Id' => '<string>',
    'Name' => '<string>',
    'ProvisioningType' => 'FLEET_PROVISIONING|JITR',
    'Tags' => ['<string>', ...],
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetRuntimeLogConfiguration

$result = $client->getRuntimeLogConfiguration([/* ... */]);
$promise = $client->getRuntimeLogConfigurationAsync([/* ... */]);

Get the runtime log configuration for a specific managed thing or for all managed things as a group.

Parameter Syntax

$result = $client->getRuntimeLogConfiguration([
    'ManagedThingId' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'ManagedThingId' => '<string>',
    'RuntimeLogConfigurations' => [
        'DeleteLocalStoreAfterUpload' => true || false,
        'LocalStoreFileRotationMaxBytes' => <integer>,
        'LocalStoreFileRotationMaxFiles' => <integer>,
        'LocalStoreLocation' => '<string>',
        'LogFlushLevel' => 'DEBUG|ERROR|INFO|WARN',
        'LogLevel' => 'DEBUG|ERROR|INFO|WARN',
        'UploadLog' => true || false,
        'UploadPeriodMinutes' => <integer>,
    ],
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

GetSchemaVersion

$result = $client->getSchemaVersion([/* ... */]);
$promise = $client->getSchemaVersionAsync([/* ... */]);

Gets a schema version with the provided information.

Parameter Syntax

$result = $client->getSchemaVersion([
    'Format' => 'AWS|ZCL|CONNECTOR',
    'SchemaVersionedId' => '<string>', // REQUIRED
    'Type' => 'capability|definition', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'Description' => '<string>',
    'Namespace' => '<string>',
    'Schema' => [
    ],
    'SchemaId' => '<string>',
    'SemanticVersion' => '<string>',
    'Type' => 'capability|definition',
    'Visibility' => 'PUBLIC|PRIVATE',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ConflictException:

There is a conflict with the request.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

Examples

Example 1: GetSchemaVersion happy path for an example schema version.

$result = $client->getSchemaVersion([
    'SchemaVersionedId' => 'matter.ColorControl@1.4',
    'Type' => 'capability',
]);

Result syntax:

[
    'Description' => 'The Color Control cluster defined as Harmony Capability.',
    'Namespace' => 'matter',
    'Schema' => [
    ],
    'SchemaId' => 'matter.ColorControl',
    'SemanticVersion' => '1.4',
    'Type' => 'capability',
]

Example 2: GetSchemaVersion happy path for an example schema version.

$result = $client->getSchemaVersion([
    'Format' => 'ZCL',
    'SchemaVersionedId' => 'matter.ColorControl@1.4',
    'Type' => 'capability',
]);

Result syntax:

[
    'Description' => 'The Color Control cluster defined as Harmony Capability.',
    'Namespace' => 'matter',
    'Schema' => [
    ],
    'SchemaId' => 'matter.ColorControl',
    'SemanticVersion' => '1.4',
    'Type' => 'capability',
]

Example 3: GetSchemaVersion error path for an example schema version that does not exist.

$result = $client->getSchemaVersion([
    'SchemaVersionedId' => 'matter.ColorControl@$latest',
    'Type' => 'capability',
]);

ListAccountAssociations

$result = $client->listAccountAssociations([/* ... */]);
$promise = $client->listAccountAssociationsAsync([/* ... */]);

Lists all account associations, with optional filtering by connector destination ID.

Parameter Syntax

$result = $client->listAccountAssociations([
    'ConnectorDestinationId' => '<string>',
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'Items' => [
        [
            'AccountAssociationId' => '<string>',
            'Arn' => '<string>',
            'AssociationState' => 'ASSOCIATION_IN_PROGRESS|ASSOCIATION_FAILED|ASSOCIATION_SUCCEEDED|ASSOCIATION_DELETING|REFRESH_TOKEN_EXPIRED',
            'ConnectorDestinationId' => '<string>',
            'Description' => '<string>',
            'ErrorMessage' => '<string>',
            'Name' => '<string>',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ServiceUnavailableException:

The service is temporarily unavailable.

ThrottlingException:

The rate exceeds the limit.

ListCloudConnectors

$result = $client->listCloudConnectors([/* ... */]);
$promise = $client->listCloudConnectorsAsync([/* ... */]);

Returns a list of connectors based on permissions.

Parameter Syntax

$result = $client->listCloudConnectors([
    'LambdaArn' => '<string>',
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
    'Type' => 'LISTED|UNLISTED',
]);

Parameter Details

Result Syntax

[
    'Items' => [
        [
            'Description' => '<string>',
            'EndpointConfig' => [
                'lambda' => [
                    'arn' => '<string>',
                ],
            ],
            'EndpointType' => 'LAMBDA',
            'Id' => '<string>',
            'Name' => '<string>',
            'Type' => 'LISTED|UNLISTED',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ThrottlingException:

The rate exceeds the limit.

Examples

Example 1: ListCloudConnectors happy path to get a list of connector resources

$result = $client->listCloudConnectors([
    'MaxResults' => 5,
]);

Result syntax:

[
    'Items' => [
        [
            'Description' => 'Description for TP Link Cloud V2',
            'EndpointConfig' => [
                'lambda' => [
                    'arn' => 'arn:aws:lambda:us-east-1:111122223333:function:my-function:myVersion',
                ],
            ],
            'EndpointType' => 'LAMBDA',
            'Name' => 'Connector for TP Link Cloud V2',
        ],
        [
            'Description' => 'Description for Ring Cloud',
            'EndpointConfig' => [
                'lambda' => [
                    'arn' => 'arn:aws:lambda:us-east-1:111122223333:function:my-function:myVersion',
                ],
            ],
            'EndpointType' => 'LAMBDA',
            'Name' => 'Connector for Ring Cloud',
        ],
    ],
]

Example 2: ListCloudConnectors error path for unauthorized user

$result = $client->listCloudConnectors([
    'MaxResults' => 5,
]);

ListConnectorDestinations

$result = $client->listConnectorDestinations([/* ... */]);
$promise = $client->listConnectorDestinationsAsync([/* ... */]);

Lists all connector destinations, with optional filtering by cloud connector ID.

Parameter Syntax

$result = $client->listConnectorDestinations([
    'CloudConnectorId' => '<string>',
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'ConnectorDestinationList' => [
        [
            'CloudConnectorId' => '<string>',
            'Description' => '<string>',
            'Id' => '<string>',
            'Name' => '<string>',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ThrottlingException:

The rate exceeds the limit.

ListCredentialLockers

$result = $client->listCredentialLockers([/* ... */]);
$promise = $client->listCredentialLockersAsync([/* ... */]);

List information on an existing credential locker.

Parameter Syntax

$result = $client->listCredentialLockers([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'Items' => [
        [
            'Arn' => '<string>',
            'CreatedAt' => <DateTime>,
            'Id' => '<string>',
            'Name' => '<string>',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ServiceUnavailableException:

The service is temporarily unavailable.

ThrottlingException:

The rate exceeds the limit.

ListDestinations

$result = $client->listDestinations([/* ... */]);
$promise = $client->listDestinationsAsync([/* ... */]);

List all destination names under one Amazon Web Services account.

Parameter Syntax

$result = $client->listDestinations([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'DestinationList' => [
        [
            'DeliveryDestinationArn' => '<string>',
            'DeliveryDestinationType' => 'KINESIS',
            'Description' => '<string>',
            'Name' => '<string>',
            'RoleArn' => '<string>',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ThrottlingException:

The rate exceeds the limit.

ListDeviceDiscoveries

$result = $client->listDeviceDiscoveries([/* ... */]);
$promise = $client->listDeviceDiscoveriesAsync([/* ... */]);

Lists all device discovery tasks, with optional filtering by type and status.

Parameter Syntax

$result = $client->listDeviceDiscoveries([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
    'StatusFilter' => 'RUNNING|SUCCEEDED|FAILED|TIMED_OUT',
    'TypeFilter' => 'ZWAVE|ZIGBEE|CLOUD|CUSTOM',
]);

Parameter Details

Result Syntax

[
    'Items' => [
        [
            'DiscoveryType' => 'ZWAVE|ZIGBEE|CLOUD|CUSTOM',
            'Id' => '<string>',
            'Status' => 'RUNNING|SUCCEEDED|FAILED|TIMED_OUT',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ThrottlingException:

The rate exceeds the limit.

ListDiscoveredDevices

$result = $client->listDiscoveredDevices([/* ... */]);
$promise = $client->listDiscoveredDevicesAsync([/* ... */]);

Lists all devices discovered during a specific device discovery task.

Parameter Syntax

$result = $client->listDiscoveredDevices([
    'Identifier' => '<string>', // REQUIRED
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'Items' => [
        [
            'AuthenticationMaterial' => '<string>',
            'Brand' => '<string>',
            'ConnectorDeviceId' => '<string>',
            'ConnectorDeviceName' => '<string>',
            'DeviceTypes' => ['<string>', ...],
            'DiscoveredAt' => <DateTime>,
            'ManagedThingId' => '<string>',
            'Model' => '<string>',
            'Modification' => 'DISCOVERED|UPDATED|NO_CHANGE',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

ListEventLogConfigurations

$result = $client->listEventLogConfigurations([/* ... */]);
$promise = $client->listEventLogConfigurationsAsync([/* ... */]);

List all event log configurations for an account.

Parameter Syntax

$result = $client->listEventLogConfigurations([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'EventLogConfigurationList' => [
        [
            'EventLogLevel' => 'DEBUG|ERROR|INFO|WARN',
            'Id' => '<string>',
            'ResourceId' => '<string>',
            'ResourceType' => '<string>',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ThrottlingException:

The rate exceeds the limit.

ListManagedThingAccountAssociations

$result = $client->listManagedThingAccountAssociations([/* ... */]);
$promise = $client->listManagedThingAccountAssociationsAsync([/* ... */]);

Lists all account associations for a specific managed thing.

Parameter Syntax

$result = $client->listManagedThingAccountAssociations([
    'AccountAssociationId' => '<string>',
    'ManagedThingId' => '<string>',
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'Items' => [
        [
            'AccountAssociationId' => '<string>',
            'ManagedThingId' => '<string>',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ThrottlingException:

The rate exceeds the limit.

ListManagedThingSchemas

$result = $client->listManagedThingSchemas([/* ... */]);
$promise = $client->listManagedThingSchemasAsync([/* ... */]);

List schemas associated with a managed thing.

Parameter Syntax

$result = $client->listManagedThingSchemas([
    'CapabilityIdFilter' => '<string>',
    'EndpointIdFilter' => '<string>',
    'Identifier' => '<string>', // REQUIRED
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'Items' => [
        [
            'CapabilityId' => '<string>',
            'EndpointId' => '<string>',
            'Schema' => [
            ],
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ResourceNotFoundException:

The specified resource does not exist.

ThrottlingException:

The rate exceeds the limit.

ListManagedThings

$result = $client->listManagedThings([/* ... */]);
$promise = $client->listManagedThingsAsync([/* ... */]);

Listing all managed things with provision for filters.

Parameter Syntax

$result = $client->listManagedThings([
    'ConnectorDestinationIdFilter' => '<string>',
    'ConnectorDeviceIdFilter' => '<string>',
    'ConnectorPolicyIdFilter' => '<string>',
    'CredentialLockerFilter' => '<string>',
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
    'OwnerFilter' => '<string>',
    'ParentControllerIdentifierFilter' => '<string>',
    'ProvisioningStatusFilter' => 'UNASSOCIATED|PRE_ASSOCIATED|DISCOVERED|ACTIVATED|DELETION_FAILED|DELETE_IN_PROGRESS|ISOLATED|DELETED',
    'RoleFilter' => 'CONTROLLER|DEVICE',
    'SerialNumberFilter' => '<string>',
]);

Parameter Details

Result Syntax

[
    'Items' => [
        [
            'ActivatedAt' => <DateTime>,
            'AdvertisedProductId' => '<string>',
            'Arn' => '<string>',
            'Brand' => '<string>',
            'Classification' => '<string>',
            'ConnectorDestinationId' => '<string>',
            'ConnectorDeviceId' => '<string>',
            'ConnectorPolicyId' => '<string>',
            'CreatedAt' => <DateTime>,
            'CredentialLockerId' => '<string>',
            'Id' => '<string>',
            'Model' => '<string>',
            'Name' => '<string>',
            'Owner' => '<string>',
            'ParentControllerId' => '<string>',
            'ProvisioningStatus' => 'UNASSOCIATED|PRE_ASSOCIATED|DISCOVERED|ACTIVATED|DELETION_FAILED|DELETE_IN_PROGRESS|ISOLATED|DELETED',
            'Role' => 'CONTROLLER|DEVICE',
            'SerialNumber' => '<string>',
            'UpdatedAt' => <DateTime>,
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ThrottlingException:

The rate exceeds the limit.

ListNotificationConfigurations

$result = $client->listNotificationConfigurations([/* ... */]);
$promise = $client->listNotificationConfigurationsAsync([/* ... */]);

List all notification configurations.

Parameter Syntax

$result = $client->listNotificationConfigurations([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'NextToken' => '<string>',
    'NotificationConfigurationList' => [
        [
            'DestinationName' => '<string>',
            'EventType' => 'DEVICE_COMMAND|DEVICE_COMMAND_REQUEST|DEVICE_DISCOVERY_STATUS|DEVICE_EVENT|DEVICE_LIFE_CYCLE|DEVICE_STATE|DEVICE_OTA|CONNECTOR_ASSOCIATION|ACCOUNT_ASSOCIATION|CONNECTOR_ERROR_REPORT',
        ],
        // ...
    ],
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ThrottlingException:

The rate exceeds the limit.

ListOtaTaskConfigurations

$result = $client->listOtaTaskConfigurations([/* ... */]);
$promise = $client->listOtaTaskConfigurationsAsync([/* ... */]);

List all of the over-the-air (OTA) task configurations.

Parameter Syntax

$result = $client->listOtaTaskConfigurations([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'Items' => [
        [
            'CreatedAt' => <DateTime>,
            'Name' => '<string>',
            'TaskConfigurationId' => '<string>',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ThrottlingException:

The rate exceeds the limit.

ListOtaTaskExecutions

$result = $client->listOtaTaskExecutions([/* ... */]);
$promise = $client->listOtaTaskExecutionsAsync([/* ... */]);

List all of the over-the-air (OTA) task executions.

Parameter Syntax

$result = $client->listOtaTaskExecutions([
    'Identifier' => '<string>', // REQUIRED
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'ExecutionSummaries' => [
        [
            'ManagedThingId' => '<string>',
            'TaskExecutionSummary' => [
                'ExecutionNumber' => <integer>,
                'LastUpdatedAt' => <DateTime>,
                'QueuedAt' => <DateTime>,
                'RetryAttempt' => <integer>,
                'StartedAt' => <DateTime>,
                'Status' => 'QUEUED|IN_PROGRESS|SUCCEEDED|FAILED|TIMED_OUT|REJECTED|REMOVED|CANCELED',
            ],
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ThrottlingException:

The rate exceeds the limit.

ResourceNotFoundException:

The specified resource does not exist.

ListOtaTasks

$result = $client->listOtaTasks([/* ... */]);
$promise = $client->listOtaTasksAsync([/* ... */]);

List all of the over-the-air (OTA) tasks.

Parameter Syntax

$result = $client->listOtaTasks([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'NextToken' => '<string>',
    'Tasks' => [
        [
            'CreatedAt' => <DateTime>,
            'LastUpdatedAt' => <DateTime>,
            'Status' => 'IN_PROGRESS|CANCELED|COMPLETED|DELETION_IN_PROGRESS|SCHEDULED',
            'TaskArn' => '<string>',
            'TaskConfigurationId' => '<string>',
            'TaskId' => '<string>',
        ],
        // ...
    ],
]

Result Details

Errors

AccessDeniedException:

User is not authorized.

ValidationException:

A validation error occurred when performing the API request.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

ThrottlingException:

The rate exceeds the limit.

ResourceNotFoundException:

The specified resource does not exist.

ListProvisioningProfiles

$result = $client->listProvisioningProfiles([/* ... */]);
$promise = $client->listProvisioningProfilesAsync([/* ... */]);

List the provisioning profiles within the Amazon Web Services account.

Parameter Syntax

$result = $client->listProvisioningProfiles([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'Items' => [
        [
            'Arn' => '<string>',
            'Id' => '<string>',
            'Name' => '<string>',
            'ProvisioningType' => 'FLEET_PROVISIONING|JITR',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

ValidationException:

A validation error occurred when performing the API request.

AccessDeniedException:

User is not authorized.

InternalServerException:

Internal error from the service that indicates an unexpected error or that the service is unavailable.

UnauthorizedException:

You are not authorized to perform this operation.

ServiceUnavailableException:

The service is temporarily unavailable.

ThrottlingException:

The rate exceeds the limit.

ListSchemaVersions

$result = $client->listSchemaVersions([/* ... */]);
$promise = $client->listSchemaVersionsAsync([/* ... */]);

Lists schema versions with the provided information.

Parameter Syntax

$result = $client->listSchemaVersions([
    'MaxResults' => <integer>,
    'Namespace' => '<string>',
    'NextToken' => '<string>',
    'SchemaId' => '<string>',
    'SemanticVersion' => '<string>',
    'Type' => 'capability|definition', // REQUIRED
    'Visibility' => 'PUBLIC|PRIVATE',
]);

Parameter Details