# Policy


## URI


`/2017-08-29/policy`

## HTTP methods


### GET


**Operation ID:** `GetPolicy`

Retrieve the JSON for your policy.


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 200 | GetPolicyResponse | 200 response | 
| 400 | ExceptionBody | The service can't process your request because of a problem in the request. Please check your request form and syntax. | 
| 403 | ExceptionBody | You don't have permissions for this action with the credentials you sent. | 
| 404 | ExceptionBody | The resource you requested does not exist. | 
| 409 | ExceptionBody | The service could not complete your request because there is a conflict with the current state of the resource. | 
| 429 | ExceptionBody | Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests. | 
| 500 | ExceptionBody | The service encountered an unexpected condition and cannot fulfill your request. | 

### PUT


**Operation ID:** `PutPolicy`

Create or change your policy. For more information about policies, see the user guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 200 | PutPolicyResponse | 200 response | 
| 400 | ExceptionBody | The service can't process your request because of a problem in the request. Please check your request form and syntax. | 
| 403 | ExceptionBody | You don't have permissions for this action with the credentials you sent. | 
| 404 | ExceptionBody | The resource you requested does not exist. | 
| 409 | ExceptionBody | The service could not complete your request because there is a conflict with the current state of the resource. | 
| 429 | ExceptionBody | Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests. | 
| 500 | ExceptionBody | The service encountered an unexpected condition and cannot fulfill your request. | 

### DELETE


**Operation ID:** `DeletePolicy`

Permanently delete a policy that you created.


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 200 | DeletePolicyResponse | 200 response | 
| 400 | ExceptionBody | The service can't process your request because of a problem in the request. Please check your request form and syntax. | 
| 403 | ExceptionBody | You don't have permissions for this action with the credentials you sent. | 
| 404 | ExceptionBody | The resource you requested does not exist. | 
| 409 | ExceptionBody | The service could not complete your request because there is a conflict with the current state of the resource. | 
| 429 | ExceptionBody | Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests. | 
| 500 | ExceptionBody | The service encountered an unexpected condition and cannot fulfill your request. | 

### OPTIONS


Supports CORS preflight requests.


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 200 | None | The request completed successfully. | 

## Schemas


### Request bodies


#### GET schema
GET

```
{
}
```

#### PUT schema
PUT

```
{
  "policy": {
    "s3Inputs": enum,
    "httpInputs": enum,
    "httpsInputs": enum
  }
}
```

#### DELETE schema
DELETE

```
{
}
```

### Response bodies


#### GetPolicyResponse schema
GetPolicyResponse

```
{
  "policy": {
    "s3Inputs": enum,
    "httpInputs": enum,
    "httpsInputs": enum
  }
}
```

#### PutPolicyResponse schema
PutPolicyResponse

```
{
  "policy": {
    "s3Inputs": enum,
    "httpInputs": enum,
    "httpsInputs": enum
  }
}
```

#### DeletePolicyResponse schema
DeletePolicyResponse

```
{
}
```

#### ExceptionBody schema
ExceptionBody

```
{
  "message": "string"
}
```

## Properties


### DeletePolicyRequest


Send a request to permanently delete a policy that you created.

### DeletePolicyResponse


Successful DELETE policy requests will return an OK message.

### ExceptionBody



| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| message | string | False |  | 

### GetPolicyRequest


Send a request to retrieve the JSON for your policy.

### GetPolicyResponse


Successful GET policy requests will return the JSON for your policy.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| policy | [Policy](#policy-model-policy) | False | A policy configures behavior that you allow or disallow for your account. For information about MediaConvert policies, see the user guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html | 

### InputPolicy


An input policy allows or disallows a job you submit to run based on the conditions that you specify.
+ `ALLOWED`
+ `DISALLOWED`

### Policy


A policy configures behavior that you allow or disallow for your account. For information about MediaConvert policies, see the user guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| httpInputs | [InputPolicy](#policy-model-inputpolicy) | False | Allow or disallow jobs that specify HTTP inputs. | 
| httpsInputs | [InputPolicy](#policy-model-inputpolicy) | False | Allow or disallow jobs that specify HTTPS inputs. | 
| s3Inputs | [InputPolicy](#policy-model-inputpolicy) | False | Allow or disallow jobs that specify Amazon S3 inputs. | 

### PutPolicyRequest


Create or change a policy by sending a request that includes your policy in JSON.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| policy | [Policy](#policy-model-policy) | True | A policy configures behavior that you allow or disallow for your account. For information about MediaConvert policies, see the user guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html | 

### PutPolicyResponse


Successful PUT policy requests will return your policy.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| policy | [Policy](#policy-model-policy) | False | A policy configures behavior that you allow or disallow for your account. For information about MediaConvert policies, see the user guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html | 

## See also


For more information about using this API in one of the language-specific AWS SDKs and references, see the following:

### GetPolicy

+ [AWS Command Line Interface V2](/goto/cli2/mediaconvert-2017-08-29/GetPolicy)
+ [AWS SDK for .NET V4](/goto/DotNetSDKV4/mediaconvert-2017-08-29/GetPolicy)
+ [AWS SDK for C\$1\$1](/goto/SdkForCpp/mediaconvert-2017-08-29/GetPolicy)
+ [AWS SDK for Go v2](/goto/SdkForGoV2/mediaconvert-2017-08-29/GetPolicy)
+ [AWS SDK for Java V2](/goto/SdkForJavaV2/mediaconvert-2017-08-29/GetPolicy)
+ [AWS SDK for JavaScript V3](/goto/SdkForJavaScriptV3/mediaconvert-2017-08-29/GetPolicy)
+ [AWS SDK for Kotlin](/goto/SdkForKotlin/mediaconvert-2017-08-29/GetPolicy)
+ [AWS SDK for PHP V3](/goto/SdkForPHPV3/mediaconvert-2017-08-29/GetPolicy)
+ [AWS SDK for Python](/goto/boto3/mediaconvert-2017-08-29/GetPolicy)
+ [AWS SDK for Ruby V3](/goto/SdkForRubyV3/mediaconvert-2017-08-29/GetPolicy)

### PutPolicy

+ [AWS Command Line Interface V2](/goto/cli2/mediaconvert-2017-08-29/PutPolicy)
+ [AWS SDK for .NET V4](/goto/DotNetSDKV4/mediaconvert-2017-08-29/PutPolicy)
+ [AWS SDK for C\$1\$1](/goto/SdkForCpp/mediaconvert-2017-08-29/PutPolicy)
+ [AWS SDK for Go v2](/goto/SdkForGoV2/mediaconvert-2017-08-29/PutPolicy)
+ [AWS SDK for Java V2](/goto/SdkForJavaV2/mediaconvert-2017-08-29/PutPolicy)
+ [AWS SDK for JavaScript V3](/goto/SdkForJavaScriptV3/mediaconvert-2017-08-29/PutPolicy)
+ [AWS SDK for Kotlin](/goto/SdkForKotlin/mediaconvert-2017-08-29/PutPolicy)
+ [AWS SDK for PHP V3](/goto/SdkForPHPV3/mediaconvert-2017-08-29/PutPolicy)
+ [AWS SDK for Python](/goto/boto3/mediaconvert-2017-08-29/PutPolicy)
+ [AWS SDK for Ruby V3](/goto/SdkForRubyV3/mediaconvert-2017-08-29/PutPolicy)

### DeletePolicy

+ [AWS Command Line Interface V2](/goto/cli2/mediaconvert-2017-08-29/DeletePolicy)
+ [AWS SDK for .NET V4](/goto/DotNetSDKV4/mediaconvert-2017-08-29/DeletePolicy)
+ [AWS SDK for C\$1\$1](/goto/SdkForCpp/mediaconvert-2017-08-29/DeletePolicy)
+ [AWS SDK for Go v2](/goto/SdkForGoV2/mediaconvert-2017-08-29/DeletePolicy)
+ [AWS SDK for Java V2](/goto/SdkForJavaV2/mediaconvert-2017-08-29/DeletePolicy)
+ [AWS SDK for JavaScript V3](/goto/SdkForJavaScriptV3/mediaconvert-2017-08-29/DeletePolicy)
+ [AWS SDK for Kotlin](/goto/SdkForKotlin/mediaconvert-2017-08-29/DeletePolicy)
+ [AWS SDK for PHP V3](/goto/SdkForPHPV3/mediaconvert-2017-08-29/DeletePolicy)
+ [AWS SDK for Python](/goto/boto3/mediaconvert-2017-08-29/DeletePolicy)
+ [AWS SDK for Ruby V3](/goto/SdkForRubyV3/mediaconvert-2017-08-29/DeletePolicy)