你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Sims - Create Or Update

创建或更新 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

资源组的名称。 此名称不区分大小写。

simGroupName
path True

string

SIM 组的名称。

正则表达式模式: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

simName
path True

string

SIM 卡的名称。

正则表达式模式: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

subscriptionId
path True

string

uuid

目标订阅的 ID。 该值必须是 UUID。

api-version
query True

string

要用于此操作的 API 版本。

请求正文

名称 必需 类型 说明
properties.internationalMobileSubscriberIdentity True

string

SIM 卡的国际移动用户标识 (IMSI) 。

properties.authenticationKey

string

SIM 卡的 Ki 值。

properties.deviceType

string

可选的自由格式文本字段,可用于记录与此 SIM 关联的设备类型,例如“摄像机”。 Azure 门户允许基于此值对 SIM 进行分组和筛选。

properties.integratedCircuitCardIdentifier

string

SIM 卡的集成电路卡 ID (ICCID) 。

properties.operatorKeyCode

string

SIM 卡的 Opc 值。

properties.simPolicy

SimPolicyResourceId

此 SIM 卡使用的 SIM 策略。 SIM 策略必须与 SIM 卡位于同一位置。

properties.staticIpConfiguration

SimStaticIpProperties[]

分配给此 SIM 的静态 IP 地址列表。 每个地址在定义的网络范围内分配,由 {attached data network, slice} 组成。

响应

名称 类型 说明
200 OK

Sim

更新成功。 该操作返回生成的 SIM 资源。

201 Created

Sim

Create成功。 该操作返回生成的 SIM 资源。

Other Status Codes

ErrorResponse

描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流。

类型: oauth2
流向: implicit
授权 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"
        }
      }
    ]
  }
}

示例响应

{
  "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"
        }
      }
    ]
  }
}
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

创建资源的标识类型。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

ProvisioningState

当前预配状态。

Sim

SIM 资源。

SimPolicyResourceId

对 SIM 策略资源的引用。

SimState

SIM 资源的状态。

SimStaticIpProperties

SIM 的静态 IP 配置,范围限定为特定的附加数据网络和切片。

SliceResourceId

对切片资源的引用。

StaticIp

在定义的网络范围内要使用的 SIM 卡的静态 IP 配置。

systemData

与资源的创建和上次修改相关的元数据。

AttachedDataNetworkResourceId

对附加数据网络资源的引用。

名称 类型 说明
id

string

附加的数据网络资源 ID。

createdByType

创建资源的标识类型。

名称 类型 说明
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

ErrorDetail

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

ErrorDetail[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

ErrorResponse

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

ProvisioningState

当前预配状态。

名称 类型 说明
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

Sim

SIM 资源。

名称 类型 说明
id

string

资源的完全限定的资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”

name

string

资源的名称

properties.authenticationKey

string

SIM 卡的 Ki 值。

properties.deviceType

string

可选的自由格式文本字段,可用于记录与此 SIM 关联的设备类型,例如“摄像机”。 Azure 门户允许基于此值对 SIM 进行分组和筛选。

properties.integratedCircuitCardIdentifier

string

SIM 卡的集成电路卡 ID (ICCID) 。

properties.internationalMobileSubscriberIdentity

string

SIM 卡的国际移动用户标识 (IMSI) 。

properties.operatorKeyCode

string

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 地址列表。 每个地址在定义的网络范围内分配,由 {attached data network, slice} 组成。

properties.vendorKeyFingerprint

string

提供此 SIM 卡的 SIM 供应商的公共密钥指纹(如果有)。

properties.vendorName

string

提供此 SIM 卡的 SIM 供应商的名称(如果有)。

systemData

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。

type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

SimPolicyResourceId

对 SIM 策略资源的引用。

名称 类型 说明
id

string

SIM 策略资源 ID。

SimState

SIM 资源的状态。

名称 类型 说明
Disabled

string

SIM 卡处于禁用状态,因为并非所有启用所需的配置都存在。

Enabled

string

已启用 SIM 卡。

Invalid

string

无法启用 SIM 卡,因为某些关联的配置无效。

SimStaticIpProperties

SIM 的静态 IP 配置,范围限定为特定的附加数据网络和切片。

名称 类型 说明
attachedDataNetwork

AttachedDataNetworkResourceId

将使用静态 IP 地址的附加数据网络。 附加数据网络和切片的组合定义了 IP 地址的网络范围。 附加的数据网络必须与 SIM 卡位于同一位置。

slice

SliceResourceId

将对其使用静态 IP 地址的网络切片。 附加数据网络和切片的组合定义了 IP 地址的网络范围。 切片必须与 SIM 卡位于同一位置。

staticIp

StaticIp

在定义的网络范围内要使用的 SIM 卡的静态 IP 配置。

SliceResourceId

对切片资源的引用。

名称 类型 说明
id

string

切片资源 ID。

StaticIp

在定义的网络范围内要使用的 SIM 卡的静态 IP 配置。

名称 类型 说明
ipv4Address

string

在此网络范围内分配给 SIM 卡的 IPv4 地址。 此地址必须位于附加数据网络中定义的 userEquipmentStaticAddressPoolPrefix 中。

systemData

与资源的创建和上次修改相关的元数据。

名称 类型 说明
createdAt

string

资源创建时间戳 (UTC) 。

createdBy

string

创建资源的标识。

createdByType

createdByType

创建资源的标识类型。

lastModifiedAt

string

资源上次修改的时间戳 (UTC)

lastModifiedBy

string

上次修改资源的标识。

lastModifiedByType

createdByType

上次修改资源的标识类型。