GetDirectoryRegistrationCommand

Suggest an Edit

A structure that contains information about your directory registration.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { PcaConnectorAdClient, GetDirectoryRegistrationCommand } from "@aws-sdk/client-pca-connector-ad"; // ES Modules import
// const { PcaConnectorAdClient, GetDirectoryRegistrationCommand } = require("@aws-sdk/client-pca-connector-ad"); // CommonJS import
const client = new PcaConnectorAdClient(config);
const input = { // GetDirectoryRegistrationRequest
  DirectoryRegistrationArn: "STRING_VALUE", // required
};
const command = new GetDirectoryRegistrationCommand(input);
const response = await client.send(command);
// { // GetDirectoryRegistrationResponse
//   DirectoryRegistration: { // DirectoryRegistration
//     Arn: "STRING_VALUE",
//     DirectoryId: "STRING_VALUE",
//     Status: "CREATING" || "ACTIVE" || "DELETING" || "FAILED",
//     StatusReason: "DIRECTORY_ACCESS_DENIED" || "DIRECTORY_RESOURCE_NOT_FOUND" || "DIRECTORY_NOT_ACTIVE" || "DIRECTORY_NOT_REACHABLE" || "DIRECTORY_TYPE_NOT_SUPPORTED" || "INTERNAL_FAILURE",
//     CreatedAt: new Date("TIMESTAMP"),
//     UpdatedAt: new Date("TIMESTAMP"),
//   },
// };

GetDirectoryRegistrationCommand Input

See GetDirectoryRegistrationCommandInput for more details

Parameter
Type
Description
DirectoryRegistrationArn
Required
string | undefined

The Amazon Resource Name (ARN) that was returned when you called CreateDirectoryRegistration .

GetDirectoryRegistrationCommand Output

See GetDirectoryRegistrationCommandOutput for details

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
DirectoryRegistration
DirectoryRegistration | undefined

The directory registration represents the authorization of the connector service with a directory.

Throws

Name
Fault
Details
AccessDeniedException
client

You can receive this error if you attempt to create a resource share when you don't have the required permissions. This can be caused by insufficient permissions in policies attached to your Amazon Web Services Identity and Access Management (IAM) principal. It can also happen because of restrictions in place from an Amazon Web Services Organizations service control policy (SCP) that affects your Amazon Web Services account.

InternalServerException
server

The request processing has failed because of an unknown error, exception or failure with an internal server.

ResourceNotFoundException
client

The operation tried to access a nonexistent resource. The resource might not be specified correctly, or its status might not be ACTIVE.

ThrottlingException
client

The limit on the number of requests per second was exceeded.

ValidationException
client

An input validation error occurred. For example, invalid characters in a template name, or if a pagination token is invalid.

PcaConnectorAdServiceException
Base exception class for all service exceptions from PcaConnectorAd service.