# UpdateProtectConfigurationCountryRuleSet


Update a country rule set to `ALLOW`, `BLOCK`, `MONITOR`, or `FILTER` messages to be sent to the specified destination counties. You can update one or multiple countries at a time. The updates are only applied to the specified NumberCapability type.

## Request Syntax


```
{
   "CountryRuleSetUpdates": { 
      "string" : { 
         "ProtectStatus": "string"
      }
   },
   "NumberCapability": "string",
   "ProtectConfigurationId": "string"
}
```

## Request Parameters


For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [CountryRuleSetUpdates](#API_UpdateProtectConfigurationCountryRuleSet_RequestSyntax) **   <a name="pinpoint-UpdateProtectConfigurationCountryRuleSet-request-CountryRuleSetUpdates"></a>
A map of ProtectConfigurationCountryRuleSetInformation objects that contain the details for the requested NumberCapability. The Key is the two-letter ISO country code. For a list of supported ISO country codes, see [Supported countries and regions (SMS channel)](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-sms-by-country.html) in the AWS End User Messaging SMS User Guide.  
For example, to set the United States as allowed and Canada as blocked, the `CountryRuleSetUpdates` would be formatted as: `"CountryRuleSetUpdates": { "US" : { "ProtectStatus": "ALLOW" } "CA" : { "ProtectStatus": "BLOCK" } }`   
Type: String to [ProtectConfigurationCountryRuleSetInformation](API_ProtectConfigurationCountryRuleSetInformation.md) object map  
Map Entries: Maximum number of 300 items.  
Key Length Constraints: Fixed length of 2.  
Key Pattern: `[A-Z]{2}`   
Required: Yes

 ** [NumberCapability](#API_UpdateProtectConfigurationCountryRuleSet_RequestSyntax) **   <a name="pinpoint-UpdateProtectConfigurationCountryRuleSet-request-NumberCapability"></a>
The number capability to apply the CountryRuleSetUpdates updates to.  
Type: String  
Valid Values: `SMS | VOICE | MMS | RCS`   
Required: Yes

 ** [ProtectConfigurationId](#API_UpdateProtectConfigurationCountryRuleSet_RequestSyntax) **   <a name="pinpoint-UpdateProtectConfigurationCountryRuleSet-request-ProtectConfigurationId"></a>
The unique identifier for the protect configuration.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `[A-Za-z0-9_:/-]+`   
Required: Yes

## Response Syntax


```
{
   "CountryRuleSet": { 
      "string" : { 
         "ProtectStatus": "string"
      }
   },
   "NumberCapability": "string",
   "ProtectConfigurationArn": "string",
   "ProtectConfigurationId": "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.

 ** [CountryRuleSet](#API_UpdateProtectConfigurationCountryRuleSet_ResponseSyntax) **   <a name="pinpoint-UpdateProtectConfigurationCountryRuleSet-response-CountryRuleSet"></a>
An array of ProtectConfigurationCountryRuleSetInformation containing the rules for the NumberCapability.  
Type: String to [ProtectConfigurationCountryRuleSetInformation](API_ProtectConfigurationCountryRuleSetInformation.md) object map  
Map Entries: Maximum number of 300 items.  
Key Length Constraints: Fixed length of 2.  
Key Pattern: `[A-Z]{2}` 

 ** [NumberCapability](#API_UpdateProtectConfigurationCountryRuleSet_ResponseSyntax) **   <a name="pinpoint-UpdateProtectConfigurationCountryRuleSet-response-NumberCapability"></a>
The number capability that was updated  
Type: String  
Valid Values: `SMS | VOICE | MMS | RCS` 

 ** [ProtectConfigurationArn](#API_UpdateProtectConfigurationCountryRuleSet_ResponseSyntax) **   <a name="pinpoint-UpdateProtectConfigurationCountryRuleSet-response-ProtectConfigurationArn"></a>
The Amazon Resource Name (ARN) of the protect configuration.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `arn:\S+` 

 ** [ProtectConfigurationId](#API_UpdateProtectConfigurationCountryRuleSet_ResponseSyntax) **   <a name="pinpoint-UpdateProtectConfigurationCountryRuleSet-response-ProtectConfigurationId"></a>
The unique identifier for the protect configuration.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `[A-Za-z0-9_-]+` 

## Errors


For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
The request was denied because you don't have sufficient permissions to access the resource.    
 ** Reason **   
The reason for the exception.
HTTP Status Code: 400

 ** InternalServerException **   
The API encountered an unexpected error and couldn't complete the request. You might be able to successfully issue the request again in the future.    
 ** RequestId **   
The unique identifier of the request.
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource couldn't be found.    
 ** ResourceId **   
The unique identifier of the resource.  
 ** ResourceType **   
The type of resource that caused the exception.
HTTP Status Code: 400

 ** ThrottlingException **   
An error that occurred because too many requests were sent during a certain amount of time.  
HTTP Status Code: 400

 ** ValidationException **   
A validation exception for a field.    
 ** Fields **   
The field that failed validation.  
 ** Reason **   
The reason for the exception.
HTTP Status Code: 400

## See Also


For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/pinpoint-sms-voice-v2-2022-03-31/UpdateProtectConfigurationCountryRuleSet) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/pinpoint-sms-voice-v2-2022-03-31/UpdateProtectConfigurationCountryRuleSet) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/pinpoint-sms-voice-v2-2022-03-31/UpdateProtectConfigurationCountryRuleSet) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/pinpoint-sms-voice-v2-2022-03-31/UpdateProtectConfigurationCountryRuleSet) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/pinpoint-sms-voice-v2-2022-03-31/UpdateProtectConfigurationCountryRuleSet) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/pinpoint-sms-voice-v2-2022-03-31/UpdateProtectConfigurationCountryRuleSet) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/pinpoint-sms-voice-v2-2022-03-31/UpdateProtectConfigurationCountryRuleSet) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/pinpoint-sms-voice-v2-2022-03-31/UpdateProtectConfigurationCountryRuleSet) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/pinpoint-sms-voice-v2-2022-03-31/UpdateProtectConfigurationCountryRuleSet) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/pinpoint-sms-voice-v2-2022-03-31/UpdateProtectConfigurationCountryRuleSet)