CreateMicrosoftAD
Creates a Microsoft AD directory in the AWS Cloud. For more information, see AWS Managed Microsoft AD in the AWS Directory Service Admin Guide.
Before you call CreateMicrosoftAD, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the CreateMicrosoftAD operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.
Request Syntax
{
"Description": "string
",
"Edition": "string
",
"Name": "string
",
"Password": "string
",
"ShortName": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
],
"VpcSettings": {
"SubnetIds": [ "string
" ],
"VpcId": "string
"
}
}
Request Parameters
The request accepts the following data in JSON format.
- Description
-
A description for the directory. This label will appear on the AWS console
Directory Details
page after the directory is created.Type: String
Length Constraints: Minimum length of 0. Maximum length of 128.
Pattern:
^([a-zA-Z0-9_])[\\a-zA-Z0-9_@#%*+=:?./!\s-]*$
Required: No
- Edition
-
AWS Managed Microsoft AD is available in two editions:
Standard
andEnterprise
.Enterprise
is the default.Type: String
Valid Values:
Enterprise | Standard
Required: No
- Name
-
The fully qualified domain name for the AWS Managed Microsoft AD directory, such as
corp.example.com
. This name will resolve inside your VPC only. It does not need to be publicly resolvable.Type: String
Pattern:
^([a-zA-Z0-9]+[\\.-])+([a-zA-Z0-9])+$
Required: Yes
- Password
-
The password for the default administrative user named
Admin
.If you need to change the password for the administrator account, you can use the ResetUserPassword API call.
Type: String
Pattern:
(?=^.{8,64}$)((?=.*\d)(?=.*[A-Z])(?=.*[a-z])|(?=.*\d)(?=.*[^A-Za-z0-9\s])(?=.*[a-z])|(?=.*[^A-Za-z0-9\s])(?=.*[A-Z])(?=.*[a-z])|(?=.*\d)(?=.*[A-Z])(?=.*[^A-Za-z0-9\s]))^.*
Required: Yes
- ShortName
-
The NetBIOS name for your domain, such as
CORP
. If you don't specify a NetBIOS name, it will default to the first part of your directory DNS. For example,CORP
for the directory DNScorp.example.com
.Type: String
Pattern:
^[^\\/:*?"<>|.]+[^\\/:*?"<>|]*$
Required: No
- Tags
-
The tags to be assigned to the AWS Managed Microsoft AD directory.
Type: Array of Tag objects
Required: No
- VpcSettings
-
Contains VPC information for the CreateDirectory or CreateMicrosoftAD operation.
Type: DirectoryVpcSettings object
Required: Yes
Response Syntax
{
"DirectoryId": "string"
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- DirectoryId
-
The identifier of the directory that was created.
Type: String
Pattern:
^d-[0-9a-f]{10}$
Errors
For information about the errors that are common to all actions, see Common Errors.
- ClientException
-
A client exception has occurred.
HTTP Status Code: 400
- DirectoryLimitExceededException
-
The maximum number of directories in the region has been reached. You can use the GetDirectoryLimits operation to determine your directory limits in the region.
HTTP Status Code: 400
- InvalidParameterException
-
One or more parameters are not valid.
HTTP Status Code: 400
- ServiceException
-
An exception has occurred in AWS Directory Service.
HTTP Status Code: 500
- UnsupportedOperationException
-
The operation is not supported.
HTTP Status Code: 400
Examples
The following examples are formatted for legibility.
Example Request
This example illustrates one usage of CreateMicrosoftAD.
POST / HTTP/1.1 Host: ds.us-west-2.amazonaws.com Accept-Encoding: identity Content-Length: 207 X-Amz-Target: DirectoryService_20150416.CreateMicrosoftAD X-Amz-Date: 20161213T231510Z User-Agent: aws-cli/1.11.24 Python/2.7.9 Windows/7 botocore/1.4.81 Content-Type: application/x-amz-json-1.1 Authorization: AWS4-HMAC-SHA256 Credential=AKIAI7E3BYXS3example/20161213/us-west-2/ds/aws4_request, SignedHeaders=content-type;host;x-amz-date;x-amz-target, Signature=5a73aaebf6dd7db4a17ffa5a0a5af7f8e134ad03034cb0b3e05e4f1a999d9e0a { "ShortName":"ad", "Password":"Str0ngP@ssw0rd", "Name":"ad.example.com", "Description":"Corporate AD directory", "VpcSettings":{ "SubnetIds":[ "subnet-ba0146de", "subnet-bef46bc8" ], "VpcId":"vpc-45025421" } }
Example Response
This example illustrates one usage of CreateMicrosoftAD.
HTTP/1.1 200 OK x-amzn-RequestId: 00019586-c18a-11e6-870b-c3330207df37 Content-Type: application/x-amz-json-1.1 Content-Length: 30 Date: Tue, 13 Dec 2016 23:15:12 GMT { "DirectoryId":"d-926example" }
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: