---
schema_version: "1"
id: e92b9ead5834a56622625180dd4c75d475fb35c41f7096e593eddc454d19c6c4
title: API アセットのバージョンの変更
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/exchange/to-change-raml-version.md
canonical_url: https://docs.mulesoft.com/jp/exchange/to-change-raml-version
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 82390a7f2c80cbd5cb1028e2bd3f2e8fc1d502bf6da57bd4c1000023f0df429d
description: MuleSoft Documentation Site
latest: true
---
# API アセットのバージョンの変更

Anypoint Exchange では、次の API アセットを作成できます。

- REST API (RAML または OAS)
- HTTP API
- SOAP API

このドキュメントでは、これらのアセットのバージョンを変更する方法について説明します。

各 API アセットには、アセットバージョン ​**\[Version (バージョン)\]**​ 項目と、API 仕様バージョンの ​**\[API version (API バージョン)\]**​ 項目があります。RAML、OAS、および SOAP アセットの場合、API 仕様バージョンはその仕様内にコード化されています。

Exchange のアセットバージョンは、メジャー、マイナー、およびパッチリリースの [セマンティックバージョン設定](https://semver.org/)​モデルに従いますが、​`ビルドメタデータ`​はサポートされません。たとえば、アセットのバージョンが 2.4.6 でメジャーバージョンが 2.x.x である場合、そのマイナーバージョンは 2.4.x で、パッチバージョンは 2.4.6 になります。

HTTP API アセットはポリシーまたはプロキシのみを提供できるエンドポイントです。HTTP API には、メジャーバージョンの増加のみがあり、マイナーバージョンやパッチバージョンの変更はありません。

アセットの新しいバージョンを作成する場合、以前のバージョンの名前、アイコン、説明が使用されます。これらのプロパティを変更するには、​[「アセットの説明」](https://docs.mulesoft.com/jp/exchange/to-describe-an-asset)​の手順を使用します。名前、アイコン、説明に対する変更は、アセットのすべてのバージョンに適用されます。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">新しいアセットバージョンは、組織の​<a href="https://docs.mulesoft.com/jp/exchange/to-create-an-asset#asset-limits" class="xref page">アセット制限</a>​に含まれます。</td></tr></tbody></table>

## [](#新しい-api-アセットのデプロイ)新しい API アセットのデプロイ

**\[Publish new asset (新規アセットをパブリッシュ)\]**​ ボタンを使用して、API アセットを Exchange に直接デプロイできます。​**\[Publish a new asset (新規アセットをパブリッシュ)\]**​ ウィンドウの \[Advanced (詳細)\] セクションでは、​**\[Version (バージョン)\]**​ 項目でアセットのバージョン、​**\[API version (API バージョン)\]**​ 項目で API 仕様のバージョンを指定できます。

更新された API 仕様に新しいバージョンと古いバージョンの後方互換性がない変更がある場合にのみ、API バージョンを変更してください。

## [](#raml-または-oas-バージョンの変更)RAML または OAS バージョンの変更

Exchange 内の RAML および OAS API 仕様では、​**\[Add version (バージョンを追加)\]**​ ボタンを使用して Exchange 内からバージョン番号を変更します。

1. アセットの詳細ペインから、​**\[Add version (バージョンを追加)\]**​ をクリックします。
2. (必須) \[API specification (API 仕様)\] に ​**\[Method (メソッド)\]**​ を選択します。
3. (必須) ​**\[File upload (ファイルのアップロード)\]**​ から ​**\[Choose file (ファイルを選択)\]**​ をクリックします。OAS の場合、.yaml または .json ファイルの種類の OAS ファイルを選択します。RAML の場合、.raml ファイルの種類の RAML ファイルを選択します。zip ファイルのルートディレクトリにあるアップロード用のファイルを含む zip ファイルも使用できます。
4. アップロードされるファイルが zip の場合、​**\[Main file (メインファイル)\]**​ を指定します。そうしないと、アップロードするファイルと同じ名前のファイルが使用されます。
5. (必須) ​**\[Version (バージョン)\]**​ で、アセットの新しいバージョンを入力します。
6. (必須) ​**\[API version (API バージョン)\]**​ で、API 仕様のバージョンを入力します。 \[Version (バージョン)\] と \[API version (API バージョン)\] の値は一致している必要があります。特定の API バージョンではマイナーバージョンの更新のみを選択できます。\[Version (バージョン)\] でメジャー番号を設定する場合、\[API version (API バージョン)\] も増やします。マイナーまたはパッチバージョンの更新を選択した場合、API バージョンは変更されません。
7. (省略可能) ​**\[Lifecycle state (ライフサイクル状態)\]**​ を選択します。デフォルトは ​**\[Stable (安定)\]**​ です。
8. **\[Publish (パブリッシュ)\]**​ をクリックします。

**\[Manage versions (バージョンを管理)\]**​ ボタンを使用してバージョンを変更することもできます。詳細は、​[「バージョンの管理」](https://docs.mulesoft.com/jp/exchange/manage-versions)​を参照してください。

次のセクションで説明するように、RAML のバージョン番号を変更します。

### [](#仕様から-raml-バージョンを変更する)仕様から RAML バージョンを変更する

RAML 仕様の ​`version:`​ 要素を変更します。 Anypoint Platform の Design Center 機能で、テキストエディターまたは API Designer を使用できます。 RAML 仕様の version 要素を更新して Exchange にパブリッシュすると、パブリッシュメニューには自動的に ​`version:`​ 要素からの変更が反映されます。

### [](#exchange-にパブリッシュするときに-raml-バージョンを変更する)Exchange にパブリッシュするときに RAML バージョンを変更する

1. Design Center から、API を開きます。変更は必要ありません。
2. **\[Publish to Exchange (Exchange へのパブリッシュ)\]**​ をクリックします。
3. **\[API Version (API バージョン)\]**​ の値を変更します。\[Asset Version (アセットバージョン)\] (Exchange アセットのバージョン) を変更することもできます。

RAML ファイルに基づく REST API が Design Center から作成されて Exchange にパブリッシュされると、API バージョンが RAML ファイルの version プロパティから取得されます。

既存の REST API の新しい API バージョンをパブリッシュすると、アセットのバージョンのメジャーセクションが更新されます。

## [](#複数の-api-とアセットのバージョン)複数の API とアセットのバージョン

各 Exchange アセットは複数のアセットバージョンを持つことができます。REST、SOAP、および HTTP API には API バージョンも含まれます。

各 API バージョンで、複数のアセットバージョンをパブリッシュできます。これらのアセットバージョンは、同じメジャーバージョンである必要があります。

たとえば、同じ API の複数のバージョンをパブリッシュすると、 バージョンは次のようになります。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">API バージョン</th>
<th class="tableblock halign-left valign-top">アセットバージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">v1</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1.0.0</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">v1</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1.0.1</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">v1</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1.1.1</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">v2</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.0.0</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">v2</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.0.2</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">v3</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">3.1.0</p></td>
</tr>
</tbody>
</table>

ただし、これらの例の値は Exchange では許可されていません。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">API バージョン</th>
<th class="tableblock halign-left valign-top">アセットバージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">v1</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1.0.0</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">v2</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1.0.1</p></td>
</tr>
</tbody>
</table>

## [](#best-practices-api-versioning)API バージョン設定のベストプラクティス

API は長期間使用するために設計する必要がありますが、変更は避けられないため、API が完全に安定することはありません。

重要なのは、包括的なバージョン設定戦略を使用して変更を管理することです。これには、複数月の廃止スケジュールと、変更について十分に詳しく説明された最新のドキュメントが含まれます。

すべての変更で新しいバージョンが必要なわけではありません。後方互換性のために設計された API は通常、大幅な変更は必要とせず、軽微な変更やパッチの変更を使用します。

API をそのように設計することが不可能な場合もあります。次の表に、新しいバージョンを導入するタイミングと新しいバージョンが不要な場合の概要を示します。通常、ユーザーが ​**\[Add new API operation (新しい API 操作を追加)\]**​ をクリックしたときに、マイナーバージョンが増えます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">変更の種別</th>
<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>サービス契約</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p>API エンドポイントの削除</p>
</li>
<li>
<p>API 操作の効果の変更</p>
</li>
<li>
<p>API 操作の応答種別の変更</p>
</li>
<li>
<p>新しい必須操作引数の追加</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>新しい API 操作の追加</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データ契約</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p>既存の要素 (または属性) の削除</p>
</li>
<li>
<p>新しい必須要素 (または必須属性) の追加</p>
</li>
<li>
<p>既存の要素 (または属性) の変更</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p>省略可能な要素 (または属性) の追加</p>
</li>
<li>
<p>派生した要素種別の追加</p>
</li>
</ul>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>表現の形式</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>既存の表現の削除</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>新しい表現の追加</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アクセシビリティ</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>権限の制限</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>権限の緩和</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#新しいメジャーバージョンを導入するタイミング)新しいメジャーバージョンを導入するタイミング

次の場合に新しいメジャーバージョンを導入する必要があります。

- サービス品質 (QoS)
    
    変更によって応答時間や可用性などのサービス品質に影響が出る場合は、API のアプリケーションで後方互換性が失われることがあるため、API のメジャーバージョンと API の変更が必要になる可能性があります。
- 出力メッセージドメイン値の変更
    
    API を使用するアプリケーションは、応答メッセージ内の項目値のドメインに依存します。たとえば、API は特定の商品や特定の支払方法のみを返す場合があります。API がドメイン外の値を返し始めた場合、既存のコンシューマーに悪影響を及ぼす可能性があります。この場合、新しいメジャーバージョンと新しい API バージョンの導入を検討します。

### [](#バージョン番号を変更するタイミング)バージョン番号を変更するタイミング

- メジャーバージョン
    
    API ユーザーにコンシューマー側のインターフェースの採用を要求する API の構造を変更するとき (操作に新しい必須の引数を追加する場合など)。
- マイナーバージョン
    
    新しい省略可能な要素の提供など、既存の API ユーザーには何も変更を求めない、後方互換性のための変更を API に導入するとき。
- パッチバージョン
    
    後方互換性のためのバグ修正や、ドキュメントの更新を導入するとき。

詳細は、 [「セマンティックバージョン設定」](https://semver.org/)​を参照してください。

### [](#アプリケーション-url-内の-api-バージョン)アプリケーション URL 内の API バージョン

API バージョンをアプリケーション URL に含めて、コンシューマーがコールするバージョンを選択できるようにします。

- オンプレミスデプロイメントの場合、バージョンはベース URI 内にあり、URL に表示されます。
    
    `http://www.example.org/v1/api/customer/1234`

### [](#命名規則)命名規則

API バージョンの定義には次のルールを使用します。

- v プレフィックスを付けてバージョンを指定する。
- 単純な序数 (v1、v2 など) を使用する。
- v1.2 などのドット表記は避ける。
- URL の一部としてメジャーバージョンのみを指定する。

## [](#api-バージョンのドキュメント化)API バージョンのドキュメント化

Exchange には、API コンシューマーのアセットに関する情報を含むドキュメントページがあります。 マイナーアセットバージョンごとに異なるドキュメントページを作成できます。

バージョンの横にあるメニューで、編集するマイナーアセットバージョンを選択してください。