---
schema_version: "1"
id: ed2369bd80ac1afc9630f9f8979c15722552f8e7139a934ecee30e0aa09f7228
title: RAML/OAS ベースの API の特性およびポリシーの概念
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/api-manager/latest/prepare-raml-task.md
canonical_url: https://docs.mulesoft.com/jp/api-manager/latest/prepare-raml-task
source_site: docs.mulesoft.com
content_type: documentation
content_hash: dffa0a0cd6b0a847852f035c68ccc4a5f0f021bb8fbfa2582a7fd8ea7f6bafdf
description: MuleSoft Documentation Site
release: 2.x
latest: true
---
# RAML/OAS ベースの API の特性およびポリシーの概念

ユーザーが参照しなければならない可能性がある RAML または OAS 定義を API が公開する場合、API 定義には、API へのコールで想定されるすべての要素が確実に記述されている必要があります。  
たとえば、クライアント ID ベースのポリシーを適用すると、API に対するすべての要求にクライアント ID とクライアントシークレット (デフォルトでクエリパラメーターとして想定される) が含まれていることを意味します。ユーザー要求が却下されることを防止するため、RAML ルートに特性を作成し、API のすべての操作でこの特性を参照します。特性は次のようになります。

```yaml
traits:
  - client-id-required:
      queryParameters:
        client_id:
          type: string
        client_secret:
          type: string
```

次に、個々の操作で次のようにこの特性を適用できます。

```yaml
/products:
  get:
    is: [client-id-required]
    description: Gets a list of all the inventory products.
```

## [](#ポリシー仕様スニペットの取得)ポリシー仕様スニペットの取得

1. API ダッシュボードで ​**\[Policies (ポリシー)\]**​ をクリックします。
    
    ポリシーのリストの RAML スニペットリンクには、API 仕様に追加する必要がある RAML trait または OAS コンポーネントが含まれています。
    
    ![\[API Manager Policies (API Manager ポリシー)\] ページ。](_images/raml-snippet.png)
2. **\[API Specification Snippet (API 仕様スニペット)\]**​ をクリックします。
3. 仕様に適合する API タイプを選択します。
    
    - API RAM バージョンに適合する RAML 0.8 または RAML 1.0。
        
        ![RAML 0.8 が選択された \[API Specification Snippet (API 仕様スニペット)\] ページ。](_images/snippet-rate-limiting.png)
    - または API OAS バージョンに適合する OAS 2.0。
        
        ![OAS 2.0 が選択された \[API Specification Snippet (API 仕様スニペット)\] ページ。](_images/prepare-raml-task-2b676.png)
        
        OAS スニペットは、すべてのポリシーバージョンで表示されるわけではありません。  
        次の表で、OAS スニペットが表示されるポリシーとバージョンを確認してください。
        
        <table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">ポリシー</th>
<th class="tableblock halign-left valign-top">バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>レート制限 - SLA ベース</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>v1.1.2 以降</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Mule OAuth プロバイダーを使用する OAuth 2.0 アクセストークン適用</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>v1.1.3 以降</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>OpenAM アクセストークン適用</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>v1.1.3 以降</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>OpenID Connect アクセストークン適用</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>v1.1.3 以降</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>PingFederate アクセストークン適用</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>v1.1.3 以降</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>クライアント ID 適用</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>v1.1.3 以降</p>
</div></div></td>
</tr>
</tbody>
</table>
4. API を編集してコードを追加します。
5. API を再デプロイします。

## [](#関連情報)関連情報

- [提供ポリシー](https://docs.mulesoft.com/jp/policies/policies-availability-by-gateway)
- [カスタムポリシー](https://docs.mulesoft.com/gateway/latest/policies-custom-overview)