次の方法で共有

Sims - Create Or Update

  • リファレンス
サービス:
Mobile Network
API バージョン:
2024-04-01

SIM を作成または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/simGroups/{simGroupName}/sims/{simName}?api-version=2024-04-01

URI パラメーター

名前 / 必須 型 説明
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

リソース グループの名前。 名前では大文字と小文字が区別されません。
simGroupName
 path True

string

maxLength: 64
pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

SIM グループの名前。
simName
 path True

string

maxLength: 64
pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

SIM の名前。
subscriptionId
 path True

string (uuid)

ターゲット サブスクリプションの ID。 値は UUID である必要があります。
api-version
 query True

string

minLength: 1

この操作に使用する API バージョン。

要求本文

名前 必須 型 説明
properties.internationalMobileSubscriberIdentity True

string

pattern: ^[0-9]{5,15}$

SIM の国際モバイル サブスクライバー ID (IMSI)。
properties.authenticationKey

string

pattern: ^[0-9a-fA-F]{32}$

SIM の Ki 値。
properties.deviceType

string

この SIM が関連付けられているデバイスの種類 ("ビデオ カメラ" など) を記録するために使用できる、オプションの自由形式のテキスト フィールド。 Azure portal では、この値に基づいて、SID をグループ化およびフィルター処理できます。
properties.integratedCircuitCardIdentifier

string

pattern: ^[0-9]{10,20}$

SIM の IC カード ID (ICCID)。
properties.operatorKeyCode

string

pattern: ^[0-9a-fA-F]{32}$

SIM の Opc 値。
properties.simPolicy

SimPolicyResourceId

この SIM で使用される SIM ポリシー。 SIM ポリシーは、SIM と同じ場所にある必要があります。
properties.staticIpConfiguration

SimStaticIpProperties[]

この SIM に割り当てられている静的 IP アドレスの一覧。 各アドレスは、{接続されたデータ ネットワーク、スライス} で構成される定義済みのネットワーク スコープで割り当てられます。

応答

名前 型 説明
200 OK

Sim

更新が成功しました。 この操作は、結果の SIM リソースを返します。
201 Created

Sim

正常に作成されます。 この操作は、結果の SIM リソースを返します。
Other Status Codes

ErrorResponse

操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

例

Create SIM

要求のサンプル

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim?api-version=2024-04-01

{
  "properties": {
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "authenticationKey": "00000000000000000000000000000000",
    "operatorKeyCode": "00000000000000000000000000000000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}

応答のサンプル

状態コード:
200 
{
  "name": "testSim",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
  "type": "Microsoft.MobileNetwork/simGroups/sims",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "simState": "Enabled",
    "siteProvisioningState": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Provisioned",
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Provisioned"
    },
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}
状態コード:
201 
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01
{
  "name": "testSim",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
  "type": "Microsoft.MobileNetwork/simGroups/sims",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "provisioningState": "Created",
    "simState": "Enabled",
    "siteProvisioningState": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Adding",
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Adding"
    },
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}

定義

名前 説明
AttachedDataNetworkResourceId

接続されているデータ ネットワーク リソースへの参照。
createdByType

リソースを作成した ID の種類。
ErrorAdditionalInfo

リソース管理エラーの追加情報。
ErrorDetail

エラーの詳細。
ErrorResponse

エラー応答
ProvisioningState

現在のプロビジョニング状態。
Sim

SIM リソース。
SimPolicyResourceId

SIM ポリシー リソースへの参照。
SimState

SIM リソースの状態。
SimStaticIpProperties

特定の接続されたデータ ネットワークとスライスを対象とする SIM の静的 IP 構成。
SliceResourceId

スライス リソースへの参照。
StaticIp

定義されたネットワーク スコープで使用する SIM の静的 IP 構成。
systemData

リソースの作成と最後の変更に関連するメタデータ。

AttachedDataNetworkResourceId

Object

接続されているデータ ネットワーク リソースへの参照。

名前 型 説明
id

string

pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK]/[pP][aA][cC][kK][eE][tT][cC][oO][rR][eE][cC][oO][nN][tT][rR][oO][lL][pP][lL][aA][nN][eE][sS]/[^/?#]+/[pP][aA][cC][kK][eE][tT][cC][oO][rR][eE][dD][aA][tT][aA][pP][lL][aA][nN][eE][sS]/[^/?#]+/[aA][tT][tT][aA][cC][hH][eE][dD][dD][aA][tT][aA][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+$

接続されたデータ ネットワーク リソース ID。

createdByType

列挙

リソースを作成した ID の種類。

値 説明
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前 型 説明
info

object

追加情報。
type

string

追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。
code

string

エラー コード。
details

ErrorDetail[]

エラーの詳細。
message

string

エラー メッセージ。
target

string

エラーターゲット。

ErrorResponse

Object

エラー応答

名前 型 説明
error

ErrorDetail

エラー オブジェクト。

ProvisioningState

列挙

現在のプロビジョニング状態。

値 説明
Accepted
Canceled
Deleted
Deleting
Failed
Succeeded
Unknown

Sim

Object

SIM リソース。

名前 型 説明
id

string (arm-id)

リソースの完全修飾リソース ID。 例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

リソースの名前
properties.authenticationKey

string

pattern: ^[0-9a-fA-F]{32}$

SIM の Ki 値。
properties.deviceType

string

この SIM が関連付けられているデバイスの種類 ("ビデオ カメラ" など) を記録するために使用できる、オプションの自由形式のテキスト フィールド。 Azure portal では、この値に基づいて、SID をグループ化およびフィルター処理できます。
properties.integratedCircuitCardIdentifier

string

pattern: ^[0-9]{10,20}$

SIM の IC カード ID (ICCID)。
properties.internationalMobileSubscriberIdentity

string

pattern: ^[0-9]{5,15}$

SIM の国際モバイル サブスクライバー ID (IMSI)。
properties.operatorKeyCode

string

pattern: ^[0-9a-fA-F]{32}$

SIM の Opc 値。
properties.provisioningState

ProvisioningState

SIM リソースのプロビジョニング状態。
properties.simPolicy

SimPolicyResourceId

この SIM で使用される SIM ポリシー。 SIM ポリシーは、SIM と同じ場所にある必要があります。
properties.simState

SimState

SIM リソースの状態。
properties.siteProvisioningState

object

サイト上のこの SIM のプロビジョニング状態を示すサイトのディクショナリ。
properties.staticIpConfiguration

SimStaticIpProperties[]

この SIM に割り当てられている静的 IP アドレスの一覧。 各アドレスは、{接続されたデータ ネットワーク、スライス} で構成される定義済みのネットワーク スコープで割り当てられます。
properties.vendorKeyFingerprint

string

この SIM を提供した SIM ベンダーの公開キーフィンガープリント (存在する場合)。
properties.vendorName

string

この SIM を提供した SIM ベンダーの名前 (存在する場合)。
systemData

systemData

createdBy と modifiedBy 情報を含む Azure Resource Manager メタデータ。
type

string

リソースの種類。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

SimPolicyResourceId

Object

SIM ポリシー リソースへの参照。

名前 型 説明
id

string

pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK]/[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+/[sS][iI][mM][pP][oO][lL][iI][cC][iI][eE][sS]/[^/?#]+$

SIM ポリシー リソース ID。

SimState

列挙

SIM リソースの状態。

値 説明
Disabled

有効にするために必要なすべての構成が存在するわけではないため、SIM は無効になっています。
Enabled

SIM が有効になっています。
Invalid

関連付けられている構成の一部が無効であるため、SIM を有効にできません。

SimStaticIpProperties

Object

特定の接続されたデータ ネットワークとスライスを対象とする SIM の静的 IP 構成。

名前 型 説明
attachedDataNetwork

AttachedDataNetworkResourceId

静的 IP アドレスが使用される接続データ ネットワーク。 接続されたデータ ネットワークとスライスの組み合わせによって、IP アドレスのネットワーク スコープが定義されます。 接続されたデータ ネットワークは、SIM と同じ場所にある必要があります。
slice

SliceResourceId

静的 IP アドレスが使用されるネットワーク スライス。 接続されたデータ ネットワークとスライスの組み合わせによって、IP アドレスのネットワーク スコープが定義されます。 スライスは SIM と同じ場所にある必要があります。
staticIp

StaticIp

定義されたネットワーク スコープで使用する SIM の静的 IP 構成。

SliceResourceId

Object

スライス リソースへの参照。

名前 型 説明
id

string

pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK]/[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+/[sS][lL][iI][cC][eE][sS]/[^/?#]+$

スライス リソース ID。

StaticIp

Object

定義されたネットワーク スコープで使用する SIM の静的 IP 構成。

名前 型 説明
ipv4Address

string

pattern: ^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$

このネットワーク スコープで SIM に割り当てられた IPv4 アドレス。 このアドレスは、接続されたデータ ネットワークで定義されている userEquipmentStaticAddressPoolPrefix に含まれている必要があります。

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前 型 説明
createdAt

string (date-time)

リソース作成のタイムスタンプ (UTC)。
createdBy

string

リソースを作成した ID。
createdByType

createdByType

リソースを作成した ID の種類。
lastModifiedAt

string (date-time)

リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy

string

リソースを最後に変更した ID。
lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。