DeleteDomain
Deletes an Amazon OpenSearch Service domain and all of its data. You can't recover a domain after you delete it.
Request Syntax
DELETE /2021-01-01/opensearch/domain/DomainName HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- DomainName
-
The name of the domain you want to permanently delete.
Length Constraints: Minimum length of 3. Maximum length of 28.
Pattern:
[a-z][a-z0-9\-]+Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"DomainStatus": {
"AccessPolicies": "string",
"AdvancedOptions": {
"string" : "string"
},
"AdvancedSecurityOptions": {
"AnonymousAuthDisableDate": number,
"AnonymousAuthEnabled": boolean,
"Enabled": boolean,
"InternalUserDatabaseEnabled": boolean,
"JWTOptions": {
"Enabled": boolean,
"PublicKey": "string",
"RolesKey": "string",
"SubjectKey": "string"
},
"SAMLOptions": {
"Enabled": boolean,
"Idp": {
"EntityId": "string",
"MetadataContent": "string"
},
"RolesKey": "string",
"SessionTimeoutMinutes": number,
"SubjectKey": "string"
}
},
"AIMLOptions": {
"NaturalLanguageQueryGenerationOptions": {
"CurrentState": "string",
"DesiredState": "string"
}
},
"ARN": "string",
"AutoTuneOptions": {
"ErrorMessage": "string",
"State": "string",
"UseOffPeakWindow": boolean
},
"ChangeProgressDetails": {
"ChangeId": "string",
"ConfigChangeStatus": "string",
"InitiatedBy": "string",
"LastUpdatedTime": number,
"Message": "string",
"StartTime": number
},
"ClusterConfig": {
"ColdStorageOptions": {
"Enabled": boolean
},
"DedicatedMasterCount": number,
"DedicatedMasterEnabled": boolean,
"DedicatedMasterType": "string",
"InstanceCount": number,
"InstanceType": "string",
"MultiAZWithStandbyEnabled": boolean,
"NodeOptions": [
{
"NodeConfig": {
"Count": number,
"Enabled": boolean,
"Type": "string"
},
"NodeType": "string"
}
],
"WarmCount": number,
"WarmEnabled": boolean,
"WarmType": "string",
"ZoneAwarenessConfig": {
"AvailabilityZoneCount": number
},
"ZoneAwarenessEnabled": boolean
},
"CognitoOptions": {
"Enabled": boolean,
"IdentityPoolId": "string",
"RoleArn": "string",
"UserPoolId": "string"
},
"Created": boolean,
"Deleted": boolean,
"DomainEndpointOptions": {
"CustomEndpoint": "string",
"CustomEndpointCertificateArn": "string",
"CustomEndpointEnabled": boolean,
"EnforceHTTPS": boolean,
"TLSSecurityPolicy": "string"
},
"DomainEndpointV2HostedZoneId": "string",
"DomainId": "string",
"DomainName": "string",
"DomainProcessingStatus": "string",
"EBSOptions": {
"EBSEnabled": boolean,
"Iops": number,
"Throughput": number,
"VolumeSize": number,
"VolumeType": "string"
},
"EncryptionAtRestOptions": {
"Enabled": boolean,
"KmsKeyId": "string"
},
"Endpoint": "string",
"Endpoints": {
"string" : "string"
},
"EndpointV2": "string",
"EngineVersion": "string",
"IdentityCenterOptions": {
"EnabledAPIAccess": boolean,
"IdentityCenterApplicationARN": "string",
"IdentityCenterInstanceARN": "string",
"IdentityStoreId": "string",
"RolesKey": "string",
"SubjectKey": "string"
},
"IPAddressType": "string",
"LogPublishingOptions": {
"string" : {
"CloudWatchLogsLogGroupArn": "string",
"Enabled": boolean
}
},
"ModifyingProperties": [
{
"ActiveValue": "string",
"Name": "string",
"PendingValue": "string",
"ValueType": "string"
}
],
"NodeToNodeEncryptionOptions": {
"Enabled": boolean
},
"OffPeakWindowOptions": {
"Enabled": boolean,
"OffPeakWindow": {
"WindowStartTime": {
"Hours": number,
"Minutes": number
}
}
},
"Processing": boolean,
"ServiceSoftwareOptions": {
"AutomatedUpdateDate": number,
"Cancellable": boolean,
"CurrentVersion": "string",
"Description": "string",
"NewVersion": "string",
"OptionalDeployment": boolean,
"UpdateAvailable": boolean,
"UpdateStatus": "string"
},
"SnapshotOptions": {
"AutomatedSnapshotStartHour": number
},
"SoftwareUpdateOptions": {
"AutoSoftwareUpdateEnabled": boolean
},
"UpgradeProcessing": boolean,
"VPCOptions": {
"AvailabilityZones": [ "string" ],
"SecurityGroupIds": [ "string" ],
"SubnetIds": [ "string" ],
"VPCId": "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.
- DomainStatus
-
The status of the domain being deleted.
Type: DomainStatus object
Errors
For information about the errors that are common to all actions, see Common Errors.
- BaseException
-
An error occurred while processing the request.
HTTP Status Code: 400
- InternalException
-
Request processing failed because of an unknown error, exception, or internal failure.
HTTP Status Code: 500
- ResourceNotFoundException
-
An exception for accessing or deleting a resource that doesn't exist.
HTTP Status Code: 409
- ValidationException
-
An exception for accessing or deleting a resource that doesn't exist.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
