本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 應用程式 applicationId 政策
<a name="applications-applicationid-policy"></a>

## URI
<a name="applications-applicationid-policy-url"></a>

`/applications/{{applicationId}}/policy`

## HTTP 方法
<a name="applications-applicationid-policy-http-methods"></a>

### GET
<a name="applications-applicationid-policyget"></a>

**操作 ID：**`GetApplicationPolicy`

擷取應用程式的 政策。


**路徑參數**  

| 名稱 | 類型 | 必要 | Description | 
| --- |--- |--- |--- |
| {{applicationId}} | String | True | 應用程式的 Amazon Resource Name (ARN)。 | 


**回應**  

| 狀態碼 | 回應模型 | Description | 
| --- |--- |--- |
| 200 | ApplicationPolicy | 成功 | 
| 400 | BadRequestException | 請求中的其中一個參數無效。 | 
| 403 | ForbiddenException | 用戶端未驗證。 | 
| 404 | NotFoundException | 請求中指定的資源 （例如，存取政策陳述式） 不存在。 | 
| 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 
| 500 | InternalServerErrorException |  AWS Serverless Application Repository 服務遇到內部錯誤。 | 

### PUT
<a name="applications-applicationid-policyput"></a>

**操作 ID：**`PutApplicationPolicy`

設定應用程式的許可政策。如需此操作支援的動作清單，請參閱[應用程式許可](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/access-control-resource-based.html#application-permissions)。


**路徑參數**  

| 名稱 | 類型 | 必要 | Description | 
| --- |--- |--- |--- |
| {{applicationId}} | String | True | 應用程式的 Amazon Resource Name (ARN)。 | 


**回應**  

| 狀態碼 | 回應模型 | Description | 
| --- |--- |--- |
| 200 | ApplicationPolicy | 成功 | 
| 400 | BadRequestException | 請求中的其中一個參數無效。 | 
| 403 | ForbiddenException | 用戶端未驗證。 | 
| 404 | NotFoundException | 請求中指定的資源 （例如，存取政策陳述式） 不存在。 | 
| 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 
| 500 | InternalServerErrorException |  AWS Serverless Application Repository 服務發生內部錯誤。 | 

### OPTIONS
<a name="applications-applicationid-policyoptions"></a>


**路徑參數**  

| 名稱 | 類型 | 必要 | Description | 
| --- |--- |--- |--- |
| {{applicationId}} | String | True | 應用程式的 Amazon Resource Name (ARN)。 | 


**回應**  

| 狀態碼 | 回應模型 | Description | 
| --- |--- |--- |
| 200 | None | 200 個回應 | 

## 結構描述
<a name="applications-applicationid-policy-schemas"></a>

### 請求內文
<a name="applications-applicationid-policy-request-examples"></a>

#### PUT 結構描述
<a name="applications-applicationid-policy-request-body-put-example"></a>

```
{
  "statements": [
    {
      "statementId": "string",
      "principals": [
        "string"
      ],
      "actions": [
        "string"
      ],
      "principalOrgIDs": [
        "string"
      ]
    }
  ]
}
```

### 回應內文
<a name="applications-applicationid-policy-response-examples"></a>

#### ApplicationPolicy 結構描述
<a name="applications-applicationid-policy-response-body-applicationpolicy-example"></a>

```
{
  "statements": [
    {
      "statementId": "string",
      "principals": [
        "string"
      ],
      "actions": [
        "string"
      ],
      "principalOrgIDs": [
        "string"
      ]
    }
  ]
}
```

#### BadRequestException 結構描述
<a name="applications-applicationid-policy-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### ForbiddenException 結構描述
<a name="applications-applicationid-policy-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### NotFoundException 結構描述
<a name="applications-applicationid-policy-response-body-notfoundexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### TooManyRequestsException 結構描述
<a name="applications-applicationid-policy-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### InternalServerErrorException 結構描述
<a name="applications-applicationid-policy-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## Properties
<a name="applications-applicationid-policy-properties"></a>

### ApplicationPolicy
<a name="applications-applicationid-policy-model-applicationpolicy"></a>

套用至應用程式的政策陳述式。


| 屬性 | Type | 必要 | Description | 
| --- |--- |--- |--- |
| 陳述式 | 類型 [ApplicationPolicyStatement](#applications-applicationid-policy-model-applicationpolicystatement) 的陣列 | True | 套用至應用程式的政策陳述式陣列。 | 

### ApplicationPolicyStatement
<a name="applications-applicationid-policy-model-applicationpolicystatement"></a>

政策陳述式已套用至應用程式。


| 屬性 | Type | 必要 | Description | 
| --- |--- |--- |--- |
| actions | 類型 string 的陣列 | True | 如需此操作支援的動作清單，請參閱[應用程式許可](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/access-control-resource-based.html#application-permissions)。 | 
| principalOrgIDs | 類型 string 的陣列 | False | 要共用應用程式的 AWS Organizations ID。 | 
| principals | 類型 string 的陣列 | True | 要與之共用應用程式 AWS 的帳戶 IDs 陣列，或將應用程式設為公有的 \*。 | 
| statementId | string | False | 陳述式的唯一 ID。 | 

### BadRequestException
<a name="applications-applicationid-policy-model-badrequestexception"></a>

請求中的其中一個參數無效。


| 屬性 | Type | 必要 | Description | 
| --- |--- |--- |--- |
| errorCode | string | False | 400 | 
| message | string | False | 請求中的其中一個參數無效。 | 

### ForbiddenException
<a name="applications-applicationid-policy-model-forbiddenexception"></a>

用戶端未驗證。


| 屬性 | Type | 必要 | Description | 
| --- |--- |--- |--- |
| errorCode | string | False | 403 | 
| message | string | False | 用戶端未驗證。 | 

### InternalServerErrorException
<a name="applications-applicationid-policy-model-internalservererrorexception"></a>

 AWS Serverless Application Repository 服務發生內部錯誤。


| 屬性 | Type | 必要 | Description | 
| --- |--- |--- |--- |
| errorCode | string | False | 500 | 
| message | string | False |  AWS Serverless Application Repository 服務發生內部錯誤。 | 

### NotFoundException
<a name="applications-applicationid-policy-model-notfoundexception"></a>

請求中指定的資源 （例如，存取政策陳述式） 不存在。


| 屬性 | Type | 必要 | Description | 
| --- |--- |--- |--- |
| errorCode | string | False | 404 | 
| message | string | False | 請求中指定的資源 （例如，存取政策陳述式） 不存在。 | 

### TooManyRequestsException
<a name="applications-applicationid-policy-model-toomanyrequestsexception"></a>

用戶端傳送的請求數量超過每單位時間允許的請求數量。


| 屬性 | Type | 必要 | Description | 
| --- |--- |--- |--- |
| errorCode | string | False | 429 | 
| message | string | False | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 

## 另請參閱
<a name="applications-applicationid-policy-see-also"></a>

如需在其中一種語言特定 AWS SDKs和參考中使用此 API 的詳細資訊，請參閱下列內容：

### GetApplicationPolicy
<a name="GetApplicationPolicy-see-also"></a>
+ [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [適用於 C\+\+ 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/GetApplicationPolicy)

### PutApplicationPolicy
<a name="PutApplicationPolicy-see-also"></a>
+ [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [適用於 C\+\+ 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/PutApplicationPolicy)