Sims - Create Or Update

Создает или обновляет SIM-карту.

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

Параметры URI

Name In Required Type Description
resourceGroupName
path True
  • string

Имя группы ресурсов. Регистр букв в имени не учитывается.

simGroupName
path True
  • string

Имя sim-группы.

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

simName
path True
  • string

Имя SIM-карты.

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

subscriptionId
path True
  • string

Идентификатор целевой подписки.

api-version
query True
  • string

Версия API, используемая для данной операции.

Текст запроса

Name Required Type Description
properties.internationalMobileSubscriberIdentity True
  • string

Удостоверение международного мобильного подписчика (IMSI) для SIM-карты.

properties.authenticationKey
  • string

Значение Ki для SIM-карты.

properties.deviceType
  • string

Необязательное текстовое поле свободной формы, которое можно использовать для записи типа устройства, с которым связана эта SIM-карта, например "Видеокамера". Портал Azure позволяет группировать и фильтровать SIM на основе этого значения.

properties.integratedCircuitCardIdentifier
  • string

Идентификатор интегрированной карты цепи (ICCID) для SIM-карты.

properties.operatorKeyCode
  • string

Значение Opc для SIM-карты.

properties.simPolicy

Политика SIM, используемая этой SIM-картой.

properties.staticIpConfiguration

Список статических IP-адресов, назначенных этой SIM-карте. Каждый адрес назначается в определенной области сети, состоящей из {подключенной сети данных, среза}.

systemData.createdAt
  • string

Метка времени создания ресурса (UTC).

systemData.createdBy
  • string

Удостоверение, создающее ресурс.

systemData.createdByType

Тип удостоверения, создавшего ресурс.

systemData.lastModifiedAt
  • string

Метка времени последнего изменения ресурса (UTC)

systemData.lastModifiedBy
  • string

Удостоверение, которое последнее изменение ресурса.

systemData.lastModifiedByType

Тип удостоверения, который последний раз изменил ресурс.

Ответы

Name Type Description
200 OK

Обновление выполнено успешно. Операция возвращает полученный ресурс SIM-карты.

201 Created

Создайте успешно. Операция возвращает полученный ресурс SIM-карты.

Other Status Codes

Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation олицетворения учетной записи пользователя

Примеры

Create SIM

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim?api-version=2022-04-01-preview

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

Sample Response

{
  "name": "testSim",
  "id": "/subscriptions/subid/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",
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}
{
  "name": "testSim",
  "id": "/subscriptions/subid/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",
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/subid/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

Статическая IP-конфигурация для SIM-карты, ограниченная определенной подключенной сетью данных и срезом.

SliceResourceId

Ссылка на ресурс среза.

StaticIp

Статическая IP-конфигурация sim-карты, используемая в определенной области сети.

systemData

Метаданные, относящиеся к созданию и последнему модификации ресурса.

AttachedDataNetworkResourceId

Ссылка на подключенный сетевой ресурс данных.

Name Type Description
id
  • string

Идентификатор подключенного сетевого ресурса данных.

createdByType

Тип удостоверения, создавшего ресурс.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Name Type Description
info
  • object

Дополнительные сведения.

type
  • string

Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Name Type Description
additionalInfo

Дополнительные сведения об ошибке.

code
  • string

Код ошибки.

details

Сведения об ошибке.

message
  • string

Сообщение об ошибке.

target
  • string

Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Name Type Description
error

Объект ошибки.

ProvisioningState

Текущее состояние подготовки.

Name Type Description
Accepted
  • string
Canceled
  • string
Deleted
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Unknown
  • string

Sim

Ресурс SIM.

Name Type Description
id
  • string

Полный идентификатор ресурса. Например, /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Имя ресурса.

properties.authenticationKey
  • string

Значение Ki для SIM-карты.

properties.deviceType
  • string

Необязательное текстовое поле свободной формы, которое можно использовать для записи типа устройства, с которым связана эта SIM-карта, например "Видеокамера". Портал Azure позволяет группировать и фильтровать SIM на основе этого значения.

properties.integratedCircuitCardIdentifier
  • string

Идентификатор интегрированной карты цепи (ICCID) для SIM-карты.

properties.internationalMobileSubscriberIdentity
  • string

Удостоверение международного мобильного подписчика (IMSI) для SIM-карты.

properties.operatorKeyCode
  • string

Значение Opc для SIM-карты.

properties.provisioningState

Состояние подготовки ресурса SIM.

properties.simPolicy

Политика SIM, используемая этой SIM-картой.

properties.simState

Состояние ресурса SIM.

properties.staticIpConfiguration

Список статических IP-адресов, назначенных этой SIM-карте. Каждый адрес назначается в определенной области сети, состоящей из {подключенной сети данных, среза}.

systemData

Метаданные Azure Resource Manager, содержащие сведения createdBy и modifiedBy.

systemData.createdAt
  • string

Метка времени создания ресурса (UTC).

systemData.createdBy
  • string

Удостоверение, создающее ресурс.

systemData.createdByType

Тип удостоверения, создавшего ресурс.

systemData.lastModifiedAt
  • string

Метка времени последнего изменения ресурса (UTC)

systemData.lastModifiedBy
  • string

Удостоверение, которое последнее изменение ресурса.

systemData.lastModifiedByType

Тип удостоверения, который последний раз изменил ресурс.

type
  • string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

SimPolicyResourceId

Ссылка на ресурс политики SIM-карты.

Name Type Description
id
  • string

Идентификатор ресурса политики SIM.

SimState

Состояние ресурса SIM.

Name Type Description
Disabled
  • string

Sim-карта отключена, так как отсутствует не все конфигурации, необходимые для включения.

Enabled
  • string

Sim-карта включена.

Invalid
  • string

Sim-карта не может быть включена, так как часть связанной конфигурации недопустима.

SimStaticIpProperties

Статическая IP-конфигурация для SIM-карты, ограниченная определенной подключенной сетью данных и срезом.

Name Type Description
attachedDataNetwork

Подключенная сеть данных, в которой будет использоваться статический IP-адрес. Сочетание подключенной сети данных и среза определяет область сети IP-адреса.

slice

Срез сети, на котором будет использоваться статический IP-адрес. Сочетание подключенной сети данных и среза определяет область сети IP-адреса.

staticIp

Статическая IP-конфигурация sim-карты, используемая в определенной области сети.

SliceResourceId

Ссылка на ресурс среза.

Name Type Description
id
  • string

Идентификатор ресурса среза.

StaticIp

Статическая IP-конфигурация sim-карты, используемая в определенной области сети.

Name Type Description
ipv4Address
  • string

IPv4-адрес, назначенный SIM-карте в этой области сети. Этот адрес должен находиться в userEquipmentStaticAddressPoolPrefix, определенном в подключенной сети данных.

systemData

Метаданные, относящиеся к созданию и последнему модификации ресурса.

Name Type Description
createdAt
  • string

Метка времени создания ресурса (UTC).

createdBy
  • string

Удостоверение, создающее ресурс.

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt
  • string

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy
  • string

Удостоверение, которое последнее изменение ресурса.

lastModifiedByType

Тип удостоверения, который последний раз изменил ресурс.