Cisco BMC REST API の例

アカウント サービスの管理

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/AccountService

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 1. アカウントサービスのプロパティ

名前

タイプ

読み取り専用

説明

AccountLockoutDuration

物理ポートの

いいえ(False)

ログイン試行の失敗回数を超えた後、アカウントがロックされたままになる秒数。「0」の値は、ロックアウトが発生しないことを意味します。AccountLockoutCounterResetEnabled が「false」の場合は無視されます。

AccountLockoutThreshold

物理ポートの

いいえ(False)

アカウントをロックする前に失敗したログイン試行回数「0」の値は、アカウントがロックされないことを意味します。

アカウント(Accounts)

オブジェクト

はい(True)

マネージャ アカウントのコレクションが含まれます。

ActiveDirectory

オブジェクト

はい(True)

ExternalAccountProvider プロパティについては、 表 2 を参照してください。

説明

文字列

はい(True)

詳細については、Resourceを参照してください。

Id

文字列

はい(True)

詳細については、Resourceを参照してください。

LDAP

オブジェクト

いいえ(False)

ExternalAccountProvider プロパティについては、 表 2 を参照してください。

MaxPasswordLength

文字列

はい(True)

許可されるパスワードの最大長。

(注)  

 

デフォルトの最大値は 20 です。

MinPasswordLength

文字列

はい(True)

必要な最短パスワード長。

(注)  

 

デフォルトの最小値は 8 です。

Name

String

はい(True)

詳細については、Resourceを参照してください。

Oem

オブジェクト

いいえ(False)

OEM 固有のプロパティ:

  • BMC:OEM 認証の定義。「表 4」を参照してください。

ロール

オブジェクト

はい(True)

RoleCollection タイプのコレクションへのリンクを提供します。

ServiceEnabled

ブール

False

このサービスが有効になっているかどうかを示します。

表 2. ExternalAccountProvider プロパティ

名前

タイプ

読み取り専用

説明

認証

オブジェクト

いいえ(False)

外部サービスに必要な認証の詳細が含まれています。

  • AuthenticationType: Readonly - True。

  • ユーザー名:サービスに接続するためのユーザー名。

  • パスワード:サービスのパスワード。PATCH 要求または PUT 要求を介して設定されます。応答では null として表示されます。

証明書

オブジェクト

はい(True)

外部アカウントプロバイダーで使用される証明書のコレクションへのリンク。

LDAPService

オブジェクト

いいえ(False)

一般的な LDAP サービスを解析するための追加のマッピング情報を提供します。

(注)  

 

詳細については、 表 3、「LDAP サービスプロパティ」を参照してください。

RemoteRoleMapping

配列

いいえ(False)

アカウント情報を外部アカウントプロバイダーからローカル Redfish ロールにマッピングするためのルール。

ServiceAddresses

配列

いいえ(False)

この外部アカウント プロバイダーにリンクされているユーザー アカウント プロバイダーのアドレス。フォーマットはプロバイダー タイプによって異なります。

ServiceEnabled

ブール

False

このサービスが現在有効になっているかどうかを示します。

表 3. LDAP サービス プロパティ

名前

タイプ

読み取り専用

説明

SearchSettings

オブジェクト

いいえ(False)

外部 LDAP サービスを検索するために必要な設定:

  • BaseDistinguishedNames:LDAP サービスの検索に使用されるベース識別名。

  • GroupsAttribute:LDAP エントリ内のユーザーのグループを含む属性名。

  • UsernameAttribute:LDAP ユーザー名エントリを含む属性名。

表 4. アカウントサービス OEM の BMC プロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

詳細については、OData プロパティ を参照してください。

@odata.type

文字列

はい(True)

詳細については、OData プロパティ を参照してください。

AuthMethods

オブジェクト

いいえ(False)

認証に使用できる複数の方法:

  • BasicAuth:基本認証のオンとオフを切り替えます。

  • Cookie:Cookie 認証のオンとオフを切り替えます。

  • SessionToken:SessionToken 認証のオン/オフを切り替えます。

  • TLS:TLS 認証のオン/オフを切り替えます。

  • XToken:XToken 認証のオンとオフを切り替えます。

PATCH

リクエスト

curl -sku {{user}}:{{password}} -X PATCH https://<username>:<password>@<BMC IP>/redfish/v1/AccountService 
-H "Content-Type:application/json" -d '{"AccountLockoutDuration": 30, "AccountLockoutThreshold": 1}'

レスポンス

{
    "@Message.ExtendedInfo": [
        {
            "@odata.type": "#Message.v1_1_1.Message",
            "Message": "The request completed successfully.",
            "MessageArgs": [],
            "MessageId": "Base.1.13.0.Success",
            "MessageSeverity": "OK",
            "Resolution": "None"
        }
    ]
}
]]

アカウント コレクションの管理

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/AccountService/Accounts
Content-Type:application/js

レスポンス

JSON 応答のプロパティについては、次を参照してください。

POST

リクエスト

curl -sku {{user}}:{{password}} -X POST <username>:<password> https://<BMC IP>redfish/v1/AccountService/
Accounts -H "Content-Type:application/json" -d '{"Enabled": true, "Password": "A11009755", "UserName": "test_user", 
"RoleId": "Operator"}'

レスポンス

{
    "@Message.ExtendedInfo": [
        {
            "@odata.type": "#Message.v1_1_1.Message",
            "Message": "The resource has been created successfully.",
            "MessageArgs": [],
            "MessageId": "Base.1.13.0.Created",
            "MessageSeverity": "OK",
            "Resolution": "None."
        }
    ]
}

マネージャ アカウントの構成

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/AccountService/Accounts/
{{Account_Instance}}Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 5. マネージャ アカウントプロパティ

名前

タイプ

読み取り専用

説明

AccountTypes

配列

はい(True)

アカウントに適用可能なさまざまなアカウントタイプを示します。

説明

文字列

はい(True)

詳細については、Resource を参照してください。

有効

ブール

False

アカウントで将来のログインを有効にするかどうかを決定します。ロックされたプロパティをオーバーライドします。

Id

文字列

はい(True)

詳細については、Resource を参照してください。

Links

オブジェクト

はい(True)

関連リソースへの参照を含みます:

  • Role:このアカウントの権限を定義するロールオブジェクトを参照します。ロール ID は RoleId プロパティと一致します。

[ロック済み(Locked)]

ブール

False

ロックアウトしきい値を超えたためにアカウントが自動的にロックされたかどうかを示します。管理者は false に設定してロックを手動で解除できます。

Locked@Redfish.AllowableValues

列挙体

はい(True)

プロパティまたはアクション パラメータで受け入れることができる文字列値を指定します。

Name

String

はい(True)

詳細については、Resource を参照してください。

パスワード

文字列

いいえ(False)

アカウント パスワードを保存します。応答では null として表示されます。フォーマット要件:

  • 必要な文字数は 8 ~ 20 文字です。

  • ユーザー名を含めることはできません。

  • 回文にはできません。

  • 連続する文字または繰り返される文字が半数を超えることはできません。

PasswordChangeRequired

ブール

True

今後アカウントにアクセスする前にパスワードの変更が必要かどうかを示します。

RoleId

文字列

いいえ(False)

アカウント ロールを定義します。使用可能な値:Administrator、Operator、および ReadOnly。

UserName

文字列

はい(True)

アカウントのユーザ名。

PATCH

リクエスト

curl -sku {{user}}:{{password}} -X PATCH https://<username>:<password>@<BMC IP>/redfish/v1/
AccountService/Accounts/test_user -H "Content-Type:application/json" -d '{"RoleId":"ReadOnly"}'

レスポンス

{
    "@Message.ExtendedInfo": [
        {
            "@odata.type": "#Message.v1_1_1.Message",
            "Message": "The request completed successfully.",
            "MessageArgs": [],
            "MessageId": "Base.1.13.0.Success",
            "MessageSeverity": "OK",
            "Resolution": "None"
        }
    ]
}

DELETE

リクエスト

curl -sku <username>:<password>@<BMC IP>/redfish/v1/AccountService/Accounts/
{{Account_Instance}}Content-Type:application/json

レスポンス

{
    "@Message.ExtendedInfo": [
        {
            "@odata.type": "#Message.v1_1_1.Message",
            "Message": "The account was successfully removed.",
            "MessageArgs": [],
            "MessageId": "Base.1.13.0.AccountRemoved",
            "MessageSeverity": "OK",
            "Resolution": "No resolution is required."
        }
    ]
}

ロール コレクションの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/AccountService/
Accounts/Roles Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、[コレクション(Collection)] を参照してください。

ロールの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/AccountService/Roles/
{{Role_Instance}}

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 6. ロール プロパティ

名前

タイプ

読み取り専用

説明

AssignedPrivileges

配列

はい(True)

ロールに含まれる Redfish 特権をリストで表示します。事前定義されたロールの場合は ReadOnly ですが、実装によってはカスタム ロールの変更が許可されている場合があります。

  • Login:サービスにログインし、リソースを読み取ります

  • ConfigureManager:マネージャを設定できます。

  • ConfigureUsers:ユーザーとそのアカウントを設定できます。

  • ConfigureSelf:現在のユーザーアカウントのパスワードを変更できます。

  • ConfigureComponents:このサービスの管理対象コンポーネントを構成します。

説明

文字列

はい(True)

詳細については、Resource を参照してください。

Id

文字列

はい(True)

詳細については、Resource を参照してください。

IsPredefined

ブール

True

ロールが事前定義された Redfish ロールとカスタム ロールのどちらであるかを示します。

Name

String

はい(True)

詳細については、Resource を参照してください。

OemPrivileges

配列

いいえ(False)

このロールの OEM 固有の権限を定義します。

RoleId

文字列

はい(True)

Id プロパティと一致するロールの名前が含まれます。

証明書サービスの構成

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/CertificateService

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 7. 証明書サービス プロパティ

名前

タイプ

読み取り専用

説明

[アクション(Actions)]

オブジェクト

はい(True)

該当する場合は、O プロパティの下にこのリソースで使用可能なアクションが含まれます。

CertificateLocations

オブジェクト

はい(True)

管理者がサービスにインストールされているすべての証明書を見つけるために使用するリソースについて説明します。

説明

文字列

はい(True)

詳細については、Resource を参照してください。

Id

文字列

はい(True)

詳細については、Resource を参照してください。

Name

String

はい(True)

詳細については、Resource を参照してください。

POST:CSR の生成

リクエスト

curl -sku {{user}}:{{password}} -X POST https://<username>:<password>@<BMC IP>/redfish/v1/
CertificateService/Actions/CertificateService.GenerateCSR/ -d @csr_file.json
csr_file.json
{
    "City": "Austin",
    "CertificateCollection": {
        "@odata.id": "/redfish/v1/Managers/bmc/NetworkProtocol/HTTPS/Certificates/"
    },
    "CommonName": "xx.xx.xx.xx",
    "Country": "US",
    "Organization": "ABC Limited",
    "OrganizationalUnit": "IT",
    "State": "AU",
    "KeyPairAlgorithm": "RSA"
}

レスポンス

{ 
    "CSRString": "-----BEGIN CERTIFICATE REQUEST----- ……………  -----END CERTIFICATE REQUEST-----\n", 
    "CertificateCollection": {"@odata.id": "/redfish/v1/Managers/bmc/NetworkProtocol/HTTPS/Certificates/" 
}

POST:ReplaceCertificate

リクエスト

curl -sku {{user}}:{{password}} -X POST https://<username>:<password>@<BMC IP>/redfish/v1/
CertificateService/Actions/CertificateService.ReplaceCertificate/ -d @certificate.json
certificate.json
{
    "CertificateString":"-----BEGIN CERTIFICATE-----……----END CERTIFICATE-----",
    "CertificateType": "PEM",
    "CertificateUri":
    {
        "@odata.id": "/redfish/v1/Managers/bmc/NetworkProtocol/HTTPS/Certificates/1"
    }
}

レスポンス

{
    "@odata.id": "/redfish/v1/Managers/bmc/NetworkProtocol/HTTPS/Certificates/1",
    "@odata.type": "#Certificate.v1_0_0.Certificate",
    "CertificateString": "-----BEGIN CERTIFICATE-----…………….-----END CERTIFICATE-----\n",
    "Description": "HTTPS certificate",
    "Id": "1",
    "Issuer": {
        "City": "TW",
        "CommonName": "TW",
        "Country": "TW",
        "Organization": "TW",
        "OrganizationalUnit": "TW",
        "State": "TW"
    },
    "KeyUsage": [],
    "Name": "HTTPS certificate",
    "Subject": {
        "City": "Austin",
        "CommonName": "xx.xx.xx.xx",
        "Country": "US",
        "Organization": "ABC Limited",
        "OrganizationalUnit": "IT",
        "State": "AU"
    },
    "ValidNotAfter": "2025-11-06T09:58:51+00:00",
    "ValidNotBefore": "2024-06-24T09:58:51+00:00"
}

証明書の場所の表示

GET

リクエスト

https://{{IP}}/redfish/v1/CertificateService/CertificateLocations
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 8. 証明書の場所のプロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

説明

文字列

はい(True)

リソースを参照してください。

Id

文字列

はい(True)

リソースを参照してください。

Links

オブジェクト

はい(True)

リソースを参照してください。

Name

String

はい(True)

リソースを参照してください。

シャーシ コレクションの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Chassis
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、コレクション を参照してください。

シャーシ プロパティの表示

シャーシ リソースは、システムの物理的なコンポーネントのプロパティを表します。スキーマの非 CPU/デバイス中心部分は、すべて、このリソースを介して、直接的または間接的にアクセスされます。この 1 つのオブジェクトは、ラック、ラック マウント サーバ、ブレード、スタンドアロン、モジュラ システム、エンクロージャ、およびその他すべてのコンテナを表すことを目的としています。

GET

リクエスト

https://{{IP}}/redfish/v1/Chassis/{{Chassis_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 9. シャーシのプロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

Id

文字列

はい(True)

リソースを参照してください。

Links

オブジェクト

はい(True)

このリソースに関連する他のリソースへのリンクを含みます。

Name

String

はい(True)

リソースを参照してください。

PCIeDevices

オブジェクト

はい(True)

このシャーシの PCIe デバイス コレクションへの参照。

PCIeSlots

オブジェクト

はい(True)

このシャーシの PCIe スロットのプロパティへのリンク。

電源

オブジェクト

はい(True)

機器およびサブコンポーネントの電力コレクション。

PowerState

文字列

はい(True)

シャーシの現在の電源状態。

Sensor

オブジェクト

はい(True)

機器およびサブコンポーネントのセンサー コレクション。

[ステータス(Status)]

オブジェクト

はい(True)

リソースを参照してください。

サーマル

オブジェクト

はい(True)

機器およびサブコンポーネントの温度コレクション。

センサー コレクションの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Chassis/{{Chassis_Instance}}/Sensors
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、コレクション を参照してください。

センサー プロパティの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Chassis/{{Chassis_Instance}}/Sensors/{{Sensor_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 10. センサープロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

Id

文字列

はい(True)

リソースを参照してください。

Name

String

はい(True)

リソースを参照してください。

読み取り(個別)

文字列

はい(True)

これは、個別のセンサーでのみサポートされます。

  • アサート:モニター対象のイベントが発生しました。

  • アサート解除:モニタ対象イベントは発生していません。

読み取り(値)

物理ポートの

はい(True)

これは、数値センサーでのみサポートされています。

センサー値。

ReadingRangeMax

物理ポートの

はい(True)

可能な最大センサー値。このプロパティの単位は、関連する Reading プロパティの単位と一致する必要があります。

(注)  

 

このプロパティは、数値センサーでのみサポートされています。

ReadingRangeMin

物理ポートの

はい(True)

可能な最小センサー値。このプロパティの単位は、関連する Reading プロパティの単位と一致する必要があります。

(注)  

 

このプロパティは、数値センサーでのみサポートされています。

ReadingType

文字列

はい(True)

センサーの読み取りタイプ:

  • Power:電力を測定します。

  • Discrete:イベント センサーとして機能します。

ReadingUnits

文字列

はい(True)

センサーの読み取りに使用される単位。

[ステータス(Status)]

オブジェクト

はい(True)

リソースを参照してください。

電源サブシステム コレクションの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Chassis/{{Chassis_Instance}}/PowerSubsystem/PowerSupplies
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、コレクション を参照してください。

GET

リクエスト

https://{{IP}}/redfish/v1/Chassis/{{Chassis_Instance}}/PowerSubsystem/PowerSupplies/{{PowerSupplies_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 11. 電源サブシステムのプロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

Id

文字列

はい(True)

リソースを参照してください。

製造業者

文字列

はい(True)

電源装置の製造元。

モデル(Model)

文字列

はい(True)

電源装置のモデル番号。

Name

String

はい(True)

リソースを参照してください。

PartNumber

文字列

はい(True)

電源装置の部品番号。

ProductVersion

文字列

はい(True)

電源装置の製品バージョン。

SerialNumber

文字列

はい(True)

電源装置のシリアル番号

[ステータス(Status)]

オブジェクト

はい(True)

ステータスの定義を参照してください。

ネットワーク アダプタ コレクションの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Chassis/{{Chassis_Instance}}/NetworkAdapters
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、[コレクション(Collection)] を参照してください。

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Chassis/{{Chassis_Instance}}/NetworkAdapters/
{{NetworkAdapters_Instance}}Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します。

表 12. ネットワーク アダプタ プロパティ

名前

タイプ

読み取り専用

説明

Id

文字列

はい(True)

詳細については、Resource を参照してください。

説明

文字列

はい(True)

詳細については、Resource を参照してください。

製造業者

文字列

はい(True)

ネットワーク アダプタの製造元。

モデル(Model)

文字列

はい(True)

ネットワーク アダプタのモデル番号。

Name

String

はい(True)

詳細については、Resource を参照してください。

PartNumber

文字列

はい(True)

ネットワーク アダプタの部品番号。

コントローラ

配列

はい(True)

ネットワーク アダプタを構成する一連のネットワーク コントローラ ASIC。

(注)  

 

詳細については、表 2を参照してください。

SerialNumber

文字列

はい(True)

ネットワーク アダプタのシリアル番号。

NetworkDeviceFunctions

配列

はい(True)

このネットワーク コントローラに関連付けられているネットワーク デバイス機能へのリンク。

  • @odata.id:NetworkDeviceFunction リソースへのリンク。

  • MACAddress:インターフェイスまたは論理ポートの構成済み MAC アドレス。

  • PermanentMACAddress:インターフェイスまたはポートに割り当てられている永続的な MAC アドレス。

NetworkPorts

オブジェクト

はい(True)

このネットワーク インターフェイスに関連付けられているネットワーク ポートへのリンク。

SKU

文字列

はい(True)

ネットワーク アダプタの製造元 SKU。

ベンダー

文字列

はい(True)

ネットワーク アダプタのベンダー。

[ステータス(Status)]

オブジェクト

はい(True)

詳細については、Resource を参照してください。

表 13. コントローラ プロパティ

名前

タイプ

読み取り専用

説明

ControllerCapabilities

オブジェクト

はい(True)

このコントローラの機能は次のとおりです:

  • DataCenterBridging:データセンター ブリッジング(DCB)機能。

  • NPAR:NIC パーティション(NPAR)機能。

  • NPIV:N ポート ID 仮想化(NPIV)機能。

  • NetworkDeviceFunctionCount:使用可能な物理機能の最大数。

  • NetworkPortCount:物理ポート数。

  • VirtualizationOffload:仮想化オフロード機能。

FirmwarePackageVersion

文字列

はい(True)

ユーザー向けファームウェア パッケージのバージョン。

Links

オブジェクト

はい(True)

関連リソースへのリンク。次を含みます:

  • NetworkDeviceFunctions:ネットワークデバイス機能へのリンク。

  • NetworkDeviceFunctions@odata.count:詳細については、[コレクション(Collection)] を参照してください。

  • NetworkPorts:このコントローラに関連付けられているネットワーク ポートへのリンク。

  • NetworkPorts@odata.count:詳細については [コレクション(Collection)] を参照してください。

  • PCIeDevices:このコントローラに関連付けられている PCIe デバイスへのリンク。

  • PCIeDevices@odata.count:詳細については、[コレクション(Collection)] を参照してください。

PCIeInterface

オブジェクト

はい(True)

PCIe インターフェイスの詳細は次のとおりです。

  • LanesInUse:デバイスで現在使用されている PCIe レーンの数。

  • MaxLases:デバイスでサポートされる PCIe レーンの最大数。

PCIe スロット プロパティの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Chassis/
{{Chassis_Instance}}/PCIeSlots Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 14. ネットワーク アダプタ プロパティ

名前

タイプ

読み取り専用

説明

Id

文字列

はい(True)

詳細については、Resource を参照してください。

説明

文字列

はい(True)

詳細については、Resource を参照してください。

Name

String

はい(True)

詳細については、Resource を参照してください。

スロット

配列

はい(True)

PCI スロット情報を格納します。

(注)  

 

詳細については、表 2を参照してください。

表 15. スロット プロパティ

名前

タイプ

読み取り専用

説明

HotPluggable

ブール

True

この PCIe スロットがホット プラグをサポートしているかどうかを示します。

レーン

物理ポートの

はい(True)

このスロットでサポートされている PCIe レーンの数。

Links

オブジェクト

はい(True)

関連リソースへのリンク。次を含みます:

  • PCIeDevices:このネットワーク コントローラに関連付けられている PCIe デバイスへのリンク。

  • PCIeDevices@odata.count:詳細については、[コレクション(Collection)] を参照してください。

ロケーション(Location)

物理ポートの

はい(True)

プロセッサの場所。

(注)  

 

詳細については、Resource を参照してください。

PCIeType

文字列

はい(True)

このデバイスで使用される PCIe 仕様のバージョン。

  • Gen1:PCIe v1.0 スロット。

  • Gen2:PCIe v2.0 スロット。

  • Gen3:PCIe v3.0 スロット。

  • Gen4:PCIe v4.0 スロット。

  • Gen5:PCIe v5.0 スロット。

[ステータス(Status)]

オブジェクト

はい(True)

詳細については、Resourceを参照してください。

JSON ファイルスキーマ コレクションの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/JsonSchemas
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、[コレクション(Collection)] を参照してください。

JSON ファイル スキーマ プロパティの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/JsonSchemas/{{JsonSchemas_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 16. イベント サブスクリプションのプロパティ

名前

タイプ

読み取り専用

説明(Description)

説明

文字列

はい(True)

詳細については、Resource を参照してください。

Id

文字列

はい(True)

詳細については、Resource を参照してください。

言語

配列

はい(True)

RFC 5646 言語コードで構成される説明。

Languages@odata.count

物理ポートの

はい(True)

詳細については、[コレクション(Collection)] を参照してください。

ロケーション(Location)

配列

はい(True)

このスキーマ ファイルのロケーション情報。

Location@odata.count

物理ポートの

はい(True)

詳細については、[コレクション(Collection)] を参照してください。

Name

String

はい(True)

詳細については、Resource を参照してください。

スキーマ(Schema)

文字列

はい(True)

スキーマの @odata.type プロパティの値。Type プロパティの Redfish 仕様構文に準拠します。

マネージャ コレクションの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、コレクション を参照してください。

マネージャ プロパティの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/{{Manager_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 17. マネージャ プロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

アクション(Actions)

オブジェクト

はい(True)

このリソースに対して利用可能なアクション。

  • Manager.Reset:BMC を再起動します。

  • Manager.ResetToDefaults:BMC をデフォルト設定にリセットします。

  • OemManager.SyncGpuDateTime:BMC 時刻を GPU と同期します。

日時(DateTime)

文字列

いいえ(False)

マネージャの現在の日時(オフセット付き)。時間の設定または読み取りに使用されます。

説明

文字列

はい(True)

リソースを参照してください。

EthernetInterfaces

オブジェクト

はい(True)

構成オプションと設定を含む、ネットワーク通信のためにマネージャーによって使用される NIC のコレクションへの参照。

FirmwareVersion

文字列

はい(True)

マネージャのファームウェア バージョン。

GraphicalConsole

オブジェクト

はい(True)

マネージャのグラフィカルコンソール(KVM-IP)サービスに関する情報。

Id

文字列

はい(True)

リソースを参照してください。

LastResetTime

文字列

はい(True)

マネージャが最後にリセットまたは再起動された日時。

Links

オブジェクト

はい(True)

Redfish 仕様に従って、このリソースに関連しているが従属していないリソースへの参照が含まれます。

LogServices

オブジェクト

はい(True)

マネージャによって使用されるログのコレクションへの参照。

ManagerDiagnosticData

オブジェクト

はい(True)

マネージャの診断データ。

ManagerType

文字列

はい(True)

このリソースが表すマネージャのタイプを表す列挙項目。

モデル(Model)

文字列

はい(True)

製造元で定義されている、このマネージャのモデル番号。

Name

String

はい(True)

リソースを参照してください。

NetworkProtocol

オブジェクト

はい(True)

マネージャによって制御されるネットワークサービスおよび設定への参照。構成オプションやネットワークサービスが含まれます。

Oem

オブジェクト

はい(True)

OEM データの保存に使用します。

  • @odata.id:文字列、True: 「ODATA プロパティ」を参照してください。

  • @odata.type:String、True: 「ODATA プロパティ」を参照してください。

  • OemManagement:Object、True:表 2を参照してください。

  • OpenBmc:Object、True:Manager OpenBmc Properties を参照してください。

  • ProvisionStatus:文字列、True:システムが RoT によって保護されているかどうかを示します。

    • Provision:システムは RoT によって保護されます。

    • Unprovision:システムは RoT によって保護されません。

  • TechSupportLogs:オブジェクト、True - 技術サポート ログ サービス。

PowerState

文字列

はい(True)

マネージャの電源状態が含まれます。

SerialConsole

オブジェクト

はい(True)

マネージャによって提供されるシリアル コンソール サービスに関する情報。表 4 を参照してください。

ServiceEntryPointUUID

文字列

はい(True)

このマネージャによって提供される Redfish サービスの UUID。

[ステータス(Status)]

オブジェクト

はい(True)

リソースを参照してください。

TimeZoneName

文字列

いいえ(False)

マネージャのタイムゾーン。

UUID

文字列

はい(True)

このマネージャの汎用一意識別子(UUID)。

VirtualMedia

オブジェクト

はい(True)

マネージャによって使用される仮想メディアのコレクションへの参照。

表 18. マネージャの OemManagement プロパティ

名前

タイプ

読み取り専用

説明

FirmwareVersion

オブジェクト

はい(True)

すべての OEM デバイスのファームウェア バージョンを表示します。

  • BIOS:文字列、True:BIOS のファームウェア バージョン

  • HIB_FPGA:文字列、True:HIB FPGA のファームウェア バージョン。

  • HIB_FPGA:文字列、True:MB FPGA のファームウェア バージョン。

  • RoT:文字列、True:RoT のファームウェア バージョン

  • SCM_FPGA:文字列、True:DC-SCM FPGA のファームウェア バージョン。

GPU

オブジェクト

はい(True)

センサーの読み取り、電力制限、ファームウェアの更新を含む GPU OEM 管理へのリンク。

NVMe

オブジェクト

はい(True)

NVMePresence へのリンク。

表 19. マネージャ OpenBmc のプロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

証明書

オブジェクト

はい(True)

トラストストア証明書へのリンク。

表 20. シリアル コンソール プロパティ

名前

タイプ

読み取り専用

説明

ConnectTypesSupported

配列

はい(True)

実装でサポートされているシリアル コンソール接続タイプを一覧表示します。

MaxConcurrentSessions

物理ポートの

はい(True)

プロトコルに関係なく、このマネージャがサポートできるサービス セッションの最大数。

ServiceEnabled

ブール

True

このマネージャに対してサービスが有効になっているかどうかを示します。

POST

リクエスト

curl -sku {{username}}:{{password}} -X POST
https://{{IP}}/redfish/v1/Managers/{{Manager_Instance}}/Actions/Manager.Reset -H "Content-Type:application/json" -d 
'{"ResetType": "ForceRestart"}'

または

curl -sku {{username}}:{{password}} -X POST
https://{{IP}}/redfish/v1/Managers/{{Manager_Instance}}/Actions/Manager.Reset -H "Content-Type:application/json" -d 
'{"ResetToDefaults": "ResetAll"}'

応答

{
    "@Message.ExtendedInfo": [
        {
            "@odata.type": "#Message.v1_1_1.Message",
            "Message": "The request completed successfully.",
            "MessageArgs": [],
            "MessageId": "Base.1.13.0.Success",
            "MessageSeverity": "OK",
            "Resolution": "None"
        }
    ]
}
表 21. Post Manager Reset プロパティ

名前

タイプ

読み取り専用

説明

ResetType

文字列

いいえ(False)

ForceRestart。 BMC のコールド リセットを行います。

ResetToDefaults

文字列

いいえ(False)

ResetAll:BMC の初期設定へのリセットを行います。

仮想メディア コレクションの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/{{Manager_Instance}}/VirtualMedia
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 22. 仮想メディア コレクションのプロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

メンバー

配列

はい(True)

このコレクションのメンバーを含みます。

Members@odata.count

物理ポートの

はい(True)

コレクションのメンバー数。

Name

String

はい(True)

リソースを参照してください。

マネージャ ネットワーク プロトコルの構成

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/{{Manager_Instance}}/NetworkProtocol
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 23. マネージャ ネットワーク プロトコル プロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

説明

文字列

はい(True)

リソースを参照してください。

[FQDN]

文字列

はい(True)

ホスト名とトップレベルドメイン名を含む、DNS により取得されたマネージャの完全修飾ドメイン名。

HTTP

オブジェクト

はい(True)

マネージャの HTTP プロトコルサポートの設定。

HTTPS

オブジェクト

はい(True)

このマネージャの HTTPS/SSL プロトコル設定の情報が含まれます。デフォルトのポートは 443 です。

HostName

文字列

はい(True)

ドメイン情報を含まない、マネージャの DNS ホスト名。

IPMI

オブジェクト

いいえ(False)

このマネージャの IPMI over LAN プロトコル設定の情報が含まれます。デフォルトのポートは 623 です。

Id

文字列

はい(True)

リソースを参照してください。

NTP

オブジェクト

いいえ(False)

マネージャの NTP プロトコル設定の情報が含まれます。

Name

String

はい(True)

リソースを参照してください。

SSH

オブジェクト

いいえ(False)

マネージャの SSH プロトコル設定の情報が含まれます。デフォルトのポートは 22 です。

[ステータス(Status)]

オブジェクト

はい(True)

リソースを参照してください。

PATCH

リクエスト

curl -sku {{username}}:{{password}} -X PATCH https://{{IP}}/redfish/v1/Managers/bmc/NetworkProtocol -H "Content-
Type:application/json" -d '{"NTP": {"NTPServers":["time.stdtime.gov.tw."], "ProtocolEnabled": true}}'

レスポンス

返答はありませんでした。

イーサネット インターフェイス コレクションの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/{{Manager_Instance}}/EthernetInterfaces
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、コレクション を参照してください。

イーサネット インターフェイスのプロパティの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/{{Manager_Instance}}/EthernetInterfaces/{{EthernetInterface_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 24. イーサネット インターフェイス プロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

DHCPv4

オブジェクト

いいえ(False)

表 2で指定されている DHCPv4 の構成が含まれます。

DHCPv6

オブジェクト

いいえ(False)

表 3で指定されている DHCPv6 の構成が含まれます。

説明

文字列

はい(True)

リソースを参照してください。

DomainName

文字列

いいえ(False)

管理の自律性、権限、または制御のレルムを識別します。

[FQDN]

文字列

いいえ(False)

これは、このインターフェイスの DNS によって取得された、完全修飾ドメイン名の全体です。

HostName

文字列

いいえ(False)

ドメイン情報のない DNS ホスト名。

IPv4Addresses

配列

いいえ(False)

このオブジェクトの配列は、このインターフェイスに割り当てられるすべての IPv4 アドレスを表します。表 4 を参照してください。

IPv4StaticAddresses

配列

いいえ(False)

このプロパティの値は、このインターフェイスに割り当てられている(必ずしも使用されているとは限らない)すべての IPv4 静的アドレスを表すために使用されるオブジェクトの配列になります。このインターフェイスによって使用されているアドレスは、IPv4Addresses プロパティにも表示されます。表 4 を参照してください。

IPv6AddressPolicyTable

配列

はい(True)

RFC6724 で定義されたアドレス選択ポリシーテーブルを表します。

IPv6Addresses

配列

はい(True)

このオブジェクトの配列には、このインターフェイスに現在割り当てられているすべての IPv6 アドレスが列挙されます。表 5 を参照してください。

IPv6DefaultGateway

文字列

はい(True)

これは、このインターフェイスで現在使用されている IPv6 のデフォルト ゲートウェイ アドレスです。

IPv6StaticAddresses

配列

いいえ(False)

このプロパティの値は、このインターフェイスの IPv6 静的接続特性を表すために使用されるオブジェクトの配列になります。表 5 を参照してください。

IPv6StaticDefaultGateways

配列

いいえ(False)

この配列の値は、このインターフェイスの IPv6 スタティック デフォルト ゲートウェイ アドレスを表します。

Id

文字列

はい(True)

リソースを参照してください。

InterfaceEnabled

ブール

False

これは、このインターフェイスが有効になっているかどうかを示します。

リンク ステータス

文字列

はい(True)

このプロパティの値は、このインターフェイス(ポート)のリンク ステータスになります。

MACAddress

文字列

はい(True)

このプロパティの値は、このインターフェイスの有効な現在の MAC アドレスになります。割り当て可能な MAC アドレスがサポートされていない場合、これは PermanentMACAddress の読み取り専用エイリアスです

MTUSize

物理ポートの

いいえ(False)

このプロパティの値は、このインターフェイスのイーサネット(MAC)フレームで渡すことができる最大のプロトコル データ ユニット(PDU)のサイズ(バイト単位)です。

Name

String

はい(True)

リソースを参照してください。

NameServers

配列

はい(True)

このインターフェイスで現在使用されている DNS ネームサーバーを表します。

SpeedMbps

物理ポートの

はい(True)

インターフェイスの現在のリンク速度(Mbps)。

StaticNameServers

配列

いいえ(False)

静的に定義された DNS サーバーの IPv4 および IPv6 アドレスのセット。

[ステータス(Status)]

オブジェクト

はい(True)

リソースを参照してください。

VLANs

オブジェクト

はい(True)

これは VLAN のコレクションの参照であり、インターフェイスが複数の VLAN をサポートする場合にのみ使用されます。

表 25. DHCPv4 のプロパティ

名前

タイプ

読み取り専用

説明

DHCPEnabled

ブール

False

このインターフェイスで DHCPv4 が有効になっているかどうかを決定します。

UseDNSServers

ブール

True

DHCPv4 提供の DNS サーバーを使用するかどうかを決定します。

UseDomainName

ブール

True

DHCPv4 提供のドメイン名を使用するかどうかを決定します。

UseNTPServers

ブール

True

DHCPv4 が提供する NTP サーバーを使用するかどうかを指定します。

表 26. DHCPv6 のプロパティ

名前

タイプ

読み取り専用

説明

OperatingMode

文字列

いいえ(False)

このプロパティは、このインターフェイス上の DHCPv6 の動作モードを制御します。DHCPv6 ステートフル モードはアドレスの構成に使用されますが、これを有効にすると、ステートレス モードも暗黙的に有効になります。

UseDNSServers

ブール

True

有効にすると、DHCPv6 ステートレスモードで提供された DNS サーバーアドレスが使用されます。

UseDomainName

ブール

True

有効にすると、DHCPv6 ステートレス モードで提供されたドメイン名が使用されます。

UseNTPServers

ブール

True

有効にすると、DHCPv6 ステートレスモードで提供された NTP サーバー アドレスが使用されます。

表 27. IPv4 アドレスのプロパティ

名前

タイプ

読み取り専用

説明

アドレス

文字列

いいえ(False)

これは IPv4 アドレスです。インターフェイスで DHCPv4 が有効になっている場合、このプロパティは読み取り専用になります。

アドレス発信元

文字列

いいえ(False)

これは、このアドレスの IPv4 ゲートウェイです。

  • 静的(Static):ユーザーが構成した静的アドレス。

  • DHCP:アドレスは DHCPv4 サービスによって提供されます。

[ゲートウェイ(Gateway)]

文字列

いいえ(False)

これは、このインターフェイスの IPv4 デフォルト ゲートウェイ アドレスです。インターフェイスで DHCPv4 が有効になっており、IPv4 デフォルト ゲートウェイ アドレスを設定するように構成されている場合、このプロパティは読み取り専用になります。

SubnetMask

文字列

いいえ(False)

これはパターン "^(?:[0-9]{1,3}\\.){3}[0-9]{1,3}$" の IPv4 アドレスです。インターフェイスで DHCPv4 が有効になっている場合、このプロパティは読み取り専用になります。

表 28. IPv6 アドレスのプロパティ

名前

タイプ

読み取り専用

説明

アドレス

文字列

いいえ(False)

ネットワーク インターフェイスに現在割り当てられている静的 IPv6 アドレス。

アドレス発信元

文字列

いいえ(False)

これは、このインターフェイスの IPv6 アドレス発信元です。

  • 静的(Static):ユーザーが構成した静的アドレス。

  • DHCPv6:アドレスは DHCPv6 サービスによって提供されます。

  • SLAAC:アドレスは IPv6 ステートレス アドレス自動設定により生成されます。

  • LinkLocal:アドレスは、外部ルータを使用しないローカル ネットワーク セグメント内の通信用リンク上に自動的に設定されます。

AddressState

文字列

いいえ(False)

他のアルゴリズムが特定のアドレスを処理する方法を定義および制御するアドレス状態。

PrefixLength

物理ポートの

いいえ(False)

このアドレスの IPv6 ネットワーク プレフィックス長を 0 ~ 128 の範囲のビット単位で指定します。

PATCH

リクエスト

curl -sku {{username}}:{{password}} -X PATCH https://{{IP}}/redfish/v1/Managers/bmc/EthernetInterfaces/eth0 -H
"Content-Type:application/json" -d '{"DHCPv4": {"DHCPEnabled": false},"IPv4StaticAddresses": [{"Address":"10.36.34.11",
"SubnetMask":"255.255.252.0", "Gateway":"10.36.32.1"}], "StaticNameServers":["8.8.8.8"]}'

レスポンス

返答はありませんでした。

証明書コレクションの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Managers/
{{Manager_Instance}}/ NetworkProtocol/HTTPS/Certificates Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、[コレクション(Collection)] を参照してください。

証明書プロパティの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Managers/
{{Manager_Instance}}/NetworkProtocol/HTTPS/ Certificates/{{Certificate_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 29. 証明書のプロパティ

名前

タイプ

読み取り専用

説明

CertificateString

文字列

はい(True)

このパラメータには証明書の文字列が含まれます。フォーマットは CertificateType プロパティ値で指定された要件に従うものとします。証明書に秘密キーが含まれている場合は、応答の文字列から秘密キーが削除されます。サービスが証明書の秘密キーを知らない状態で、証明書を使用する必要がある場合、クライアントは POST 要求の文字列の一部として秘密キーを提供します。

説明

文字列

はい(True)

Resource を参照してください。

Id

文字列

はい(True)

Resource を参照してください。

Issuer

オブジェクト

はい(True)

証明書発行者。表 2 を参照してください。

KeyUsage

配列

はい(True)

キー使用拡張。この証明書の公開キーの目的を定義します。

  • KeyEncipherment:プライベートつまり秘密鍵を暗号化します。

Name

String

はい(True)

Resource を参照してください。

サブジェクト

オブジェクト

はい(True)

CA 証明書の題名。表 2 を参照してください。証明書に関する識別子情報。

ValidNotAfter

文字列

はい(True)

証明書が無効になる日付。

ValidNotBefore

文字列

はい(True)

証明書が有効になる日付。

表 30. 証明書に関する識別子情報

名前

タイプ

読み取り専用

説明

市区町村郡(City)

文字列

はい(True)

エンティティの組織の市区町村または所在地。

CommonName

文字列

はい(True)

エンティティの完全修飾ドメイン名。

国(Country)

文字列

はい(True)

エンティティの組織の国。

[組織(Organization)]

文字列

はい(True)

エンティティの組織の名前。

OrganizationalUnit

文字列

はい(True)

エンティティの組織の部門名または部署名。

ステータス

文字列

はい(True)

エンティティの組織の州、都道府県、または地域。

メッセージ レジストリ ファイル コレクションの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Registries
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、[コレクション(Collection)] を参照してください。

メッセージ レジストリ ファイルのプロパティの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Registries/
{{Registry_Instance}}Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 31. 証明書のプロパティ

名前

タイプ

読み取り専用

説明(Description)

説明

文字列

はい(True)

Resource を参照してください。

Id

文字列

はい(True)

Resource を参照してください。

言語

配列

はい(True)

これは、レジストリの RFC 5646 に準拠した言語コードです。このプロパティの値は、RFC 5646 言語コードで構成される説明になります。

Languages@odata.count

物理ポートの

はい(True)

[コレクション(Collection)] を参照してください。

ロケーション(Location)

オブジェクト

はい(True)

表 2 を参照してください。

Location@odata.count

物理ポートの

はい(True)

[コレクション(Collection)] を参照してください。

Name

String

はい(True)

[コレクション(Collection)] を参照してください。

レジストリ

文字列

はい(True)

レジストリ名と、そのメジャー バージョンとマイナー バージョン。このレジストリとしては、メッセージレジストリ、権限レジストリ、属性レジストリなど、任意のタイプのレジストリがあり得ます。

表 32. レジストリ ファイルのロケーション情報

名前

タイプ

読み取り専用

説明

言語

文字列

はい(True)

レジストリ ファイルの言語コード。

PublicationUri

文字列

はい(True)

レジストリのパブリックに利用可能な(正規の)URI へのリンク。

Uri

文字列

はい(True)

レジストリのローカルに利用可能な URI へのリンク。

コンピュータ システム コレクションの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Systems
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、[コレクション(Collection)] を参照してください。

コンピュータ システム プロパティの表示

GET:コンピュータ システム インスタンス

リクエスト

https://{{IP}}/redfish/v1/Systems/{{System_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 33. コンピュータ システム プロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

アクション(Actions)

オブジェクト

はい(True)

このリソースに対して使用可能なアクション。

AssetTag

文字列

いいえ(False)

ユーザーがこのシステムに割り当てたアセット タグ。

Bios

オブジェクト

はい(True)

このシステムに関連付けられている BIOS 設定へのリンク。

Boot

オブジェクト

はい(True)

現在のリソースの起動情報を説明するプロパティが含まれます。変更によって、BIOS の永続ブート順序の設定が変更されることはありません。

説明

文字列

はい(True)

リソースを参照してください。

GraphicalConsole

オブジェクト

はい(True)

このマネージャのグラフィカル コンソール(KVM-IP)サービスに関する情報。

HostWatchdogTimer

オブジェクト

はい(True)

このシステムのホスト ウォッチドッグ タイマー機能。表 2 を参照してください。

Id

文字列

はい(True)

リソースを参照してください。

LastResetTime

文字列

はい(True)

システムが最後にリセットまたは再起動された日時。

Links

オブジェクト

はい(True)

Redfish 仕様に従って、このリソースに関連するリソースへの参照を含みますが、リソース自体は含まれません。

LocationIndicatorActive

ブール

False

オペレータがこのリソースを物理的に特定できるようにするインジケータ。

LogServices

オブジェクト

はい(True)

このシステムに関連付けられているログ サービスのコレクションへの参照。

製造業者

文字列

はい(True)

このシステムのメーカー。

メモリ

オブジェクト

はい(True)

このシステムに関連付けられているメモリのコレクションへの参照。

モデル(Model)

文字列

はい(True)

このシステムのモデル。

Name

String

はい(True)

リソースを参照してください。

Oem

オブジェクト

はい(True)

Cisco OEM 拡張プロパティ。 Cisco OEM 拡張プロパティを参照してください。

  • Cisco:Cisco OEM 拡張プロパティ

PCIeDevices

オブジェクト

はい(True)

このコンピュータ システムで使用される PCIe デバイスのコレクションへのリンク。

PCIeDevices@odata.count

物理ポートの

はい(True)

コレクションを参照してください。

PartNumber

文字列

はい(True)

このシステムの部品番号。

PowerRestorePolicy

文字列

いいえ(False)

電源がシステムに接続されているときのシステムの望ましい PowerState を示します。

  • AlwaysOn:電源投入時、システムは常に電源オンの状態です。

  • AlwaysOff:電源投入時、システムは常に電源オフのままです。

  • LastState:電源投入時、システムは前回の電源状態(オンまたはオフ)に戻ります。

PowerState

文字列

はい(True)

システムの現在の電力状態。

ProcessorSummary

オブジェクト

はい(True)

システムの中央処理装置の一般的な詳細を示します。表 4 を参照してください。

プロセッサ

オブジェクト

はい(True)

このシステムに関連付けられているプロセッサのコレクションへの参照。

SecureBoot

オブジェクト

はい(True)

このシステムに関連付けられている SecureBoot のコレクションへの参照。

SerialConsole

オブジェクト

はい(True)

このシステムが提供するシリアル コンソール サービス。表 5 を参照してください。

SerialNumber

文字列

はい(True)

システムのシリアル番号。

[ステータス(Status)]

オブジェクト

はい(True)

リソースを参照してください。

ストレージ

オブジェクト

はい(True)

このシステムに関連付けられているストレージ デバイスのコレクションへの参照。

SubModel

文字列

はい(True)

このシステムのサブモデル。モデル/製品名または製造元の名前は含まれません。

SystemType

文字列

はい(True)

このリソースが表すシステムの種類を示します。

  • Physical:コンピュータシステム。

TrustedModules

配列

はい(True)

システム内で信頼されたモジュールの配列。

  • FirmwareVersion:文字列、True:この信頼できるモジュールのファームウェア バージョン。

  • FirmwareVersion2:文字列、True:この信頼できるモジュールの拡張ファームウェア バージョン。

  • InterfaceType:文字列、True:この信頼できるモジュールのインターフェイス タイプ。

    • TPM1_2:トラステッド プラットフォーム モジュール(TPM)1.2

    • TPM2_0:トラステッド プラットフォーム モジュール(TPM)2.0

    • TCM1_0:トラステッド暗号化モジュール(TCM)1.0

  • InterfaceTypeSelection:文字列、True:このトラステッド モジュールでサポートされているインターフェイスタイプの選択。

  • Oem:配列、True:OEM 拡張プロパティ。

  • Status:オブジェクト、True:参照

  • Vendor ID:文字列、True:この信頼できるモジュールのベンダー ID。

  • Status:オブジェクト、True:

    リソースを参照してください。

UUID

文字列

はい(True)

リソースを参照してください。

表 34. HostWatchdogTimer プロパティ

名前

タイプ

読み取り専用

説明

FunctionEnabled

ブール

True

ユーザーがホスト ウォッチドッグ タイマー機能を有効にしているかどうかを示します。このプロパティは、ユーザーがタイマーを有効にしたことのみを示します。タイマーをアクティブにするには、追加のホスト ベースのソフトウェアをインストールする必要があります。このプロパティを更新しても、タイマーは開始されません。

[ステータス(Status)]

オブジェクト

はい(True)

リソースを参照してください。

TimeoutAction

文字列

はい(True)

WatchdogTimeoutActions の列挙は、ホストのウォッチドッグ タイマーがタイムアウト値に達したときに実行するアクションの選択を指定します。

  • None:アクションは実行されません。

  • ResetSystem:システムをリセットします。

  • PowerCycle:システムの電源サイクルを実施します。

  • PowerDown:システムの電源を切ります。

表 35. Cisco OEM 拡張プロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

BmcBootCompleted

ブール

True

BMC のブート状態を示します。

BiosPostComplete

ブール

True

システム BIOS のポスト ステージを示します。

ファミリ

文字列

はい(True)

ハードコード文字列「Cisco UCS Rack Server」。

MemorySummary

オブジェクト

はい(True)

一般的なシステムの中央メモリについて詳しく説明します。

  • EffectiveMemoryGiB:数値、True:現在サーバーが使用できる実際のメモリの量。

  • EffectiveSpeedMHz:数値、True - メモリの速度(メガヘルツ単位)。

  • FailedDIMMCount:数値、True:障害が発生し、使用できない DIMM の数。

  • FailedMemoryGiB:数値、True:現在障害が発生しているメモリの量(メガバイト単位)。

  • Status:オブジェクト、True:リソースを参照してください。

  • TotalSystemMemoryGiB:数値、True」構成済みのオペレーティングシステムがアクセス可能なメモリ(RAM)の合計。ギビバイト単位。

表 36. ProcessorSummary プロパティ

名前

タイプ

読み取り専用

説明

CoreCount

物理ポートの

はい(True)

CPU のコアの数

数

物理ポートの

はい(True)

システム内のプロセッサの数。

[ステータス(Status)]

オブジェクト

はい(True)

リソースを参照してください。

表 37. SerialConsole プロパティ

名前

タイプ

読み取り専用

説明

ConnectTypesSupported

配列

はい(True)

このプロパティは、実装で許可されているシリアル コンソール接続のタイプを列挙します。

  • IPMI:コントローラは、IPMI Serial Over LAN(SOL)プロトコルによるシリアル コンソール接続をサポートしています。

  • Oem:コントローラは、OEM 固有のプロトコルによるシリアル コンソール接続をサポートします。

  • SSH:コントローラは、SSH プロトコルを介したシリアル コンソール接続をサポートしています。

  • Telnet:コントローラは、Telnet プロトコルを介したシリアル コンソール接続をサポートしています。

MaxConcurrentSessions

物理ポートの

はい(True)

プロトコルに関係なく、このシステムがサポートできるサービス セッションの最大数。

SSH

オブジェクト

はい(True)

SSH シリアル コンソール サービスの接続の詳細。

  • HotKeySequenceDisplay:文字列、True:ユーザーがシリアル コンソール セッションを終了するために使用できるホットキー シーケンス。

  • Port:番号、True:SSH 接続のプロトコルのポート。

  • ServiceEnabled:ブール値、True:このシステムでサービスが有効になっているかどうかを示します。

POST

リクエスト

curl -sku {{username}}:{{password}} -X POST
https://{{IP}}/redfish/v1/Systems/{{System_Instance}}/Actions/ComputerSystem.Reset -H "Content-Type:application/json" -
d '{"ResetType": "ForceOff"}'

レスポンス

{
    "@Message.ExtendedInfo": [
        {
            "@odata.type": "#Message.v1_1_1.Message",
            "Message": "The request completed successfully.",
            "MessageArgs": [],
            "MessageId": "Base.1.13.0.Success",
            "MessageSeverity": "OK",
            "Resolution": "None"
        }
    ]
}
表 38. コンピュータ システム リセット プロパティ

名前

タイプ

読み取り専用

説明

ResetType

文字列

はい(True)

リセットのタイプ。

  • On:ユニットの電源をオンにします。

  • ForceOn:ユニットの電源をすぐにオンにします。

  • ForceOff:ユニットの電源をすぐにオフにします(非グレースフル シャットダウン)。

  • GracefulShutdown:グレースフル シャットダウンし、電源をオフにします。

  • GracefulRestart:ユニットをグレースフル シャットダウンし、再起動します。

  • PowerCycle:ユニットの電源サイクルを実施します。これにより、電源の取り外しが完了し、その後リソースに電源が復元されます。

GET - BIOS インスタンス

リクエスト

https://{{IP}}/redfish/v1/Systems/{{System_Instance}}/Bios
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 39. コンピュータ システム プロパティ

名前

タイプ

読み取り専用

説明

@Redfish.Settings

オブジェクト

はい(True)

BIOS 設定に変更を加えるためのシステム固有の BIOS 属性およびアクションについて説明します。通常、BIOS に加えた変更を有効にするには、システムのリセットが必要です。クライアントがこのリソースで「@Redfish.Settings」という用語を見つける可能性があります。見つかった場合、クライアントは「@Redfish.Settings」という用語で識別されるリソースを変更して、BIOS設定の変更を要求します。

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

アクション(Actions)

オブジェクト

はい(True)

このリソースに対して使用可能なアクション。

属性

オブジェクト

はい(True)

製造元またはプロバイダーによって決定された BIOS 属性とその値のリスト。表 8 を参照してください。

説明

Null、文字列

はい(True)

リソースを参照してください。

Id

文字列

はい(True)

リソースを参照してください。

Name

String

はい(True)

リソースを参照してください。

ResetBios

ブール

False

このアクションは、BIOS 属性をデフォルトにリセットします。

表 40. 属性プロパティ

名前

タイプ

読み取り専用

説明

(パターン)

配列、ブール値、整数、数値、オブジェクト、文字列

いいえ(False)

プロパティ名は正規表現パターン 、"^([azA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\.[a-zAZ_][a-zA-Z0-9_]*$ に従います。

(パターン)

文字列、ブール値、数値

いいえ(False)

プロパティ名は正規表現パターン「"^[AZa-z][A-Za-z0-9_]+$ に従います。

POST:BIOS 設定

リクエスト

curl -ksu {{username}}:{{password}} https://{{IP}}/redfish/v1/Systems/system/Bios/Actions/Bios.ResetBios -X POST -d
'{"ResetBios":True}'

レスポンス

返答はありませんでした。

PATCH:BIOS 設定

リクエスト

BIOS トークンの変更

curl -ksu {{username}}:{{password}} https://{{IP}}/redfish/v1/Systems/system/Bios/Settings -H "Content-
Type:application/json" -H 'If-Match:' -X PATCH -d '{"Attributes":{"CPU005":"CPU005Disabled"}}'

ブート順序変更

curl -k -H "Content-Type: application/json" -X PATCH https://{{username}}:{{password}}@{{IP}}/redfish/v1/Systems/system
-d '{"Boot":{"BootOrder":["Boot0002", "Boot0001"]}}’

応答

返答はありませんでした。

メモリ コレクションの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Systems/{{System_Instance}}/Memory
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、コレクション を参照してください。

メモリのプロパティの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Systems/{{System_Instance}}/Memory/{{Memory_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 41. メモリ プロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

AllocationAlignmentMiB

物理ポートの

はい(True)

メモリ領域が割り当てられる境界。メビバイト(MiB)単位で測定されます。

AllocationIncrementMiB

物理ポートの

はい(True)

メモリ領域の最小割り当て単位のサイズ。メビバイト(MiB)単位。

AllowedSpeedsMHz

配列

はい(True)

このメモリ デバイスによってサポートされる速度。

BaseModuleType

文字列

はい(True)

メモリ デバイスの基本モジュール タイプ。

  • RDIMM:Registered DIMM.

  • UDIMM:UDIMM。

  • SO_DIMM:SO_DIMM。

  • LRDIMM:負荷軽減型。

  • Mini_RDIMM:Mini_RDIMM。

  • Mini_UDIMM:Mini_UDIMM。

  • SO_RDIMM_72b:SO_RDIMM_72b。

  • SO_UDIMM_72b:SO_UDIMM_72b。

  • SO_DIMM_16b:SO_DIMM_16b。

  • SO_DIMM_32b:SO_DIMM_32b。

  • Die:パッケージ内のダイ。

BusWidthBits

物理ポートの

はい(True)

バス幅(ビット単位)。

CacheSizeMiB

物理ポートの

はい(True)

キャッシュ部分のメモリの合計サイズ(MiB)。

CapacityMiB

物理ポートの

はい(True)

メモリ容量。メビバイト(MiB)単位。

ConfigurationLocked

ブール

True

このメモリデバイスの構成がロックされ、変更できないかどうかを示します。

DataWidthBits

物理ポートの

はい(True)

データ幅(ビット)。

ErrorCorrection

文字列

はい(True)

このメモリデバイスでサポートされているエラー訂正スキーム。

  • NoECC: ECC は使用できません。

  • SingleBitECC:ECC により 1 ビットのデータエラーを修正できます。

  • MultiBitECC:ECC により複数ビットのデータエラーを修正できます。

  • AddressParity:アドレスパリティエラーを修正できます。

FirmwareRevision

文字列

はい(True)

メモリ コントローラのファームウェアのリビジョン。

Id

文字列

はい(True)

リソースを参照してください。

IsRankSpareEnabled

ブール

True

このメモリ デバイスでランク スペアが有効かどうかを示します。

IsSpareDeviceEnabled

ブール

True

このメモリ デバイスでスペア デバイスが有効かどうかを示します。

ロケーション(Location)

オブジェクト

はい(True)

リソースを参照してください。

製造業者

文字列

はい(True)

メモリ デバイスの製造者。

MemoryDeviceType

文字列

はい(True)

メモリ デバイス タイプに関する詳細。

  • DDR4:ダブル データ レート タイプ 4 同期ダイナミック ランダムアクセス メモリ。

  • DDR4_SDRAM:ダブル データ レート タイプ 4 同期ダイナミック ランダムアクセス メモリ。

  • DDR5:ダブル データ レート タイプ 5 同期ダイナミック ランダムアクセス メモリ。

MemoryLocation

オブジェクト

はい(True)

メモリ接続ソケットおよびメモリ コントローラの情報。表 2 を参照してください。

MemoryMedia

配列

はい(True)

このメモリ デバイスのメディア。

  • DRAM:DRAM メディア。

  • NAND:NAND メディア。

  • Intel3DXPoint:Intel 3D XPoint メディア。

メモリ サブ システム コントローラ 製造元 ID

文字列

はい(True)

このメモリ デバイスのメモリ サブシステム コントローラの製造元 ID。

メモリ サブ システム コントローラ 製品 ID

文字列

はい(True)

このメモリ デバイスのメモリ サブシステム コントローラの製品 ID。

MemoryType

文字列

はい(True)

メモリ デバイスのタイプ。

  • DRAM:メモリ デバイスは揮発性メモリで構成されています。

  • NVDIMM_N:メモリ デバイスは、不揮発性メモリにバックアップされる揮発性メモリで構成されています。

  • NVDIMM_F:メモリ デバイスは不揮発性メモリで構成されています。

  • NVDIMM_P:メモリ デバイスは不揮発性メモリと揮発性メモリの組み合わせで構成されています。

  • IntelOptane:メモリ デバイスは Intel Optane パーシステント メモリ モジュールです。

モデル(Model)

文字列

はい(True)

このメモリ デバイスの製品モデル番号。

ModuleManufacturerID

文字列

はい(True)

このメモリ デバイスの製造元 ID。

ModuleProductID

文字列

はい(True)

メモリ デバイスの製品 ID。

Name

String

はい(True)

リソースを参照してください。

NonVolatileSizeMiB

物理ポートの

はい(True)

不揮発性部分メモリの合計サイズ(MiB)。

OperatingMemoryModes

配列

はい(True)

メモリ デバイスでサポートされるメモリ モード。

  • Volatile:揮発性メモリ。

  • PMEM:システムのアドレス空間を介してバイトアクセス可能な永続メモリ。

  • Block:ブロック アクセス可能なシステムメモリ。

OperatingSpeedMhz

物理ポートの

はい(True)

メモリデバイスの動作速度(必要に応じて MHz または MT/s)。

PartNumber

文字列

はい(True)

メモリの部品番号。

PersistentRegionNumberLimit

物理ポートの

はい(True)

このメモリ デバイスがサポートできる永続領域の合計。

PersistentRegionSizeLimitMiB

物理ポートの

はい(True)

永続的なリージョンの合計サイズ(メビバイト単位)。

PersistentRegionSizeMaxMiB

物理ポートの

はい(True)

単一永続リージョンの最大サイズ(メビバイト単位)。

RankCount

物理ポートの

はい(True)

メモリ デバイスで使用可能なランクの数。

SecurityCapabilities

オブジェクト

はい(True)

メモリ デバイスのセキュリティ機能。セキュリティ機能プロパティを参照してください。

SerialNumber

文字列

はい(True)

このメモリ デバイスの製品シリアル番号。

SpareDeviceCount

物理ポートの

はい(True)

このメモリ デバイス内で使用可能な未使用のスペア デバイスの数。

SparePartNumber

文字列

はい(True)

このメモリ デバイスのスペア部品番号。

[ステータス(Status)]

オブジェクト

はい(True)

リソースを参照してください。

VolatileRegionNumberLimit

物理ポートの

はい(True)

このメモリ デバイスがサポートできる揮発性リージョンの合計。

VolatileRegionSizeLimitMiB

物理ポートの

はい(True)

揮発性リージョンの合計サイズ(メビバイト単位)。

VolatileRegionSizeMaxMiB

物理ポートの

はい(True)

単一の揮発性リージョンの最大サイズ(メビバイト単位)。

VolatileSizeMiB

物理ポートの

はい(True)

揮発性部分メモリの合計サイズ(メビバイト単位)。

表 42. メモリ ロケーションのプロパティ

名前

タイプ

読み取り専用

説明

チャネル

物理ポートの

はい(True)

メモリ デバイスの接続先であるチャネル番号。

MemoryController

物理ポートの

はい(True)

メモリ デバイスの接続先であるメモリ コントローラの番号。

スロット

物理ポートの

はい(True)

メモリ デバイスが接続先であるスロットの番号。

ソケット

物理ポートの

はい(True)

メモリ デバイスの接続先であるソケットの番号。

表 43. セキュリティ機能プロパティ

名前

タイプ

読み取り専用

説明

ConfigurationLockCapable

ブール

True

このメモリ デバイスが構成のロックまたはフリーズをサポートしているかどうかを示します。

DataLockCapable

ブール

True

このメモリ デバイスがデータ ロックをサポートしているかどうかを示します。

MaxPassphraseCount

物理ポートの

はい(True)

このメモリ デバイスでサポートされるパスフレーズの最大数。

PassphraseCapable

ブール

True

メモリ デバイスがパスフレーズを使用できるかどうかを示します。

PassphraseLockLimit

物理ポートの

はい(True)

誤ったパスフレーズが許容される最大試行回数(何回間違うとメモリ デバイスがロックされるか)。

プロセッサ コレクションの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Systems/{{System_Instance}}/Processors
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、コレクション を参照してください。

プロセッサ プロパティの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Systems/{{System_Instance}}/Processors/{{Processor_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 44. プロセッサ プロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

AssetTag

文字列

はい(True)

このプロセッサにユーザーが割り当てたアセット タグ。

ConnectedProcessors

配列

はい(True)

このプロセッサに直接接続されているプロセッサ リソースへのリンクの配列。

ConnectedProcessors@odata.count

物理ポートの

はい(True)

コレクション内のアイテムの数。

Id

文字列

はい(True)

リソースを参照してください。

InstructionSet

文字列

はい(True)

プロセッサの命令セット。

  • ARM-A32:ARM 32 ビット。

  • ARM-A64:ARM 64 ビット。

  • IA-64:Intel IA-64。

  • MIPS32:MIPS 32 ビット。

  • MIPS64:MIPS 64 ビット。

  • OEM:OEM 定義。

  • PowerISA:PowerISA-64 または PowerISA-32。

  • RV32:RISC-V 32 ビット。

  • RV64:RISC-V 64 ビット。

  • x86:x86 32 ビット。

  • x86-64:x86 64 ビット。

製造業者

文字列

はい(True)

プロセッサの製造元。

MaxSpeedMHz

物理ポートの

はい(True)

プロセッサの最大クロック速度。

モデル(Model)

文字列

はい(True)

プロセッサの製品モデル番号。

Name

String

はい(True)

リソースを参照してください。

PartNumber

文字列

はい(True)

プロセッサの部品番号。

ProcessorArchitecture

文字列

はい(True)

プロセッサのアーキテクチャ。

  • x86:x86 または x86-64。

  • IA-64:Intel Itanium。

  • ARM:ARM。

  • MIPS:MIPS。

  • Power:Power。

  • OEM:OEM 定義。

プロセッサ ID

配列

はい(True)

プロセッサの識別情報

  • [Step]:このプロセッサの製造元が提供するステップまたはリビジョンの文字列情報を示します。

ProcessorMemory

配列

はい(True)

プロセッサ内に直接接続または統合されたメモリを表します。表 2 を参照してください。

ProcessorType

文字列

はい(True)

プロセッサのタイプ。表 3 を参照してください。

SerialNumber

文字列

はい(True)

プロセッサのシリアル番号。

ソケット

文字列

はい(True)

プロセッサのソケットまたは位置。

[ステータス(Status)]

オブジェクト

はい(True)

リソースを参照してください。

SubProcessors

オブジェクト

はい(True)

プロセッサを構成するコアやスレッドなど、このプロセッサに関連付けられているサブプロセッサのコレクションへのリンク。

TotalCores

物理ポートの

はい(True)

このプロセッサに含まれるコアの合計数。

TotalThreads

物理ポートの

はい(True)

このプロセッサがサポートする実行スレッドの合計数。

バージョン

文字列

はい(True)

プロセッサのハードウェア バージョン。

表 45. プロセッサ メモリ プロパティ

名前

タイプ

読み取り専用

説明

CapacityMiB

物理ポートの

はい(True)

メモリ容量(MiB 単位)。

IntegratedMemory

ブール

True

このメモリがプロセッサ内に統合されているかどうかを示します。

MemoryType

文字列

はい(True)

このプロセッサによって使用されるメモリのタイプ。

  • DDR:ダブル データ レート同期ダイナミック ランダムアクセス メモリ。

  • DDR2:ダブル データ レート タイプ 2 同期ダイナミック ランダムアクセス メモリ。

  • DDR3:ダブル データ レート タイプ 3 同期ダイナミック ランダムアクセス メモリ。

  • DDR4:ダブル データ レート タイプ 4 同期ダイナミック ランダムアクセス メモリ。

  • DDR5:ダブル データ レート タイプ 5 同期ダイナミック ランダムアクセス メモリ。

  • Flash:フラッシュ メモリ。

  • GDDR:同期グラフィックス ランダムアクセス メモリ。

  • GDDR2:ダブル データ レート タイプ 2 同期グラフィックス ランダムアクセス メモリ。

  • GDDR3:ダブル データ レート タイプ 3 同期グラフィックス ランダムアクセス メモリ。

  • GDDR4:ダブル データ レート タイプ4 同期グラフィックス ランダムアクセス メモリ。

  • GDDR5:ダブル データ レート タイプ 5 同期グラフィックス ランダムアクセス メモリ。

  • GDDR5X:ダブル データ レート タイプ 5 X 同期グラフィックス ランダムアクセス メモリ。

  • GDDR6:ダブル データ レート タイプ 6 同期グラフィックス ランダムアクセス メモリ。

  • HBM1:高帯域幅メモリ。

  • HBM2:高帯域幅メモリ第 2 世代。

  • HBM3:高帯域幅メモリ第 3 世代。

  • L1Cache:L1 キャッシュ。

  • L2Cache:L2 キャッシュ。

  • L3Cache:L3 キャッシュ。

  • L4Cache:L4 キャッシュ。

  • L5Cache:L5 キャッシュ。

  • L6Cache:L6 キャッシュ。

  • L7Cache:L7 キャッシュ。

  • OEM:OEM 定義。

  • SDRAM:同期ダイナミック ランダムアクセス メモリ。

  • SGRAM:同期グラフィックス RAM。

  • SRAM:静的ランダム アクセス メモリ。

表 46. プロセッサ タイプ列挙

列挙体

説明

アクセラレータ

アクセラレータ。

CPU

CPU。

コア

プロセッサ内のコア。

DSP

DSP。

FPGA

FPGA。

GPU

GPU。

OEM

OEM 定義の処理ユニット。

Partition

シングル プロセッサ内のパーティション。

Thread

プロセッサ内のスレッド。

サブ プロセッサ コレクションの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Systems/{{System_Instance}}/Processors/{{Processor_Instance}}/SubProcessors
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、コレクション を参照してください。

サブ プロセッサとスレッド プロパティの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Systems/{{System_Instance}}/Processors/{{Processor_Instance}}/SubProcessors/{{SubProcessor_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 47. サブプロセッサ プロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

Id

文字列

はい(True)

リソースを参照してください。

Links

オブジェクト

はい(True)

リンクオブジェクトには、このリソースに関連する次のような他のリソースへのリンクが含まれます:

  • ConnectedProcessors:配列、True:このプロセッサに直接接続されたプロセッサへのリンクの配列。

  • ConnectedProcessors@odata.count:Number、True:コレクション内のアイテムの数。

Name

String

はい(True)

リソースを参照してください。

ProcessorType

文字列

はい(True)

プロセッサのタイプ。プロセッサ タイプ列挙を参照してください。

TotalThreads

物理ポートの

はい(True)

このプロセッサがサポートする実行スレッドの合計数。

PCIe デバイス プロパティの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Systems/
{{System_Instance}}/ PCIeDevices/{{PCIeDevices_Instance}} Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 48. PCIeデバイス プロパティ

名前

タイプ

読み取り専用

説明

Id

文字列

はい(True)

Resource を参照してください。

製造業者

文字列

はい(True)

PCIe デバイスのメーカー。

モデル(Model)

文字列

はい(True)

PCIe デバイスのモデル番号。

Name

String

はい(True)

Resource を参照してください。

PCIeFunctions

オブジェクト

はい(True)

この PCIe デバイスに関連付けられている PCIe 機能のコレクションへのリンク。

PCIeInterface

オブジェクト

はい(True)

この PCIe デバイスの PCIe インターフェイスの詳細。表 2 を参照してください。

PartNumber

文字列

はい(True)

この PCIe デバイスの部品番号。

SerialNumber

文字列

はい(True)

この PCIe デバイスのシリアル番号。

スロット

配列

はい(True)

PCI スロット情報の配列。表 2 を参照してください。

[ステータス(Status)]

オブジェクト

はい(True)

Resource を参照してください。

表 49. PCIe インターフェイスのプロパティ

名前

タイプ

読み取り専用

説明

LanesInUse

物理ポートの

はい(True)

このデバイスで使用されている PCIe レーンの数。

MaxLanes

物理ポートの

はい(True)

このデバイスでサポートされている PCIe レーンの数。

MaxPCIeType

文字列

はい(True)

このデバイスでサポートされている PCIe 仕様の最新バージョン。

  • Gen1:PCIe v1.0 スロット。

  • Gen2:PCIe v2.0 スロット。

  • Gen3:PCIe v3.0 スロット。

  • Gen4:PCIe v4.0 スロット。

  • Gen5:PCIe v5.0 スロット。

PCIeType

文字列

はい(True)

このデバイスで使用されている PCIe 仕様のバージョン。

  • Gen1:PCIe v1.0 スロット。

  • Gen2:PCIe v2.0 スロット。

  • Gen3:PCIe v3.0 スロット。

  • Gen4:PCIe v4.0 スロット。

  • Gen5:PCIe v5.0 スロット。

PCIe 関数コレクションの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Systems/
{System_Instance}}/PCIeDevices/{{PCIeDevices_Instance}}/PCIeFunctions
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、[コレクション(Collection)] を参照してください。

PCIe 機能プロパティの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Systems/
{{System_Instance}}/PCIeDevices/{{PCIeDevices_Instance}}/PCIeFunctions/
{{PCIeFunctions_Instance}}Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 50. PCIe 機能プロパティ

名前

タイプ

読み取り専用

説明

ClassCode

文字列

はい(True)

この PCIe 機能のクラスコード。

DeviceClass

文字列

はい(True)

この PCIe 機能のクラス。

DeviceId

文字列

はい(True)

この PCIe 機能のデバイス ID。

FunctionId

物理ポートの

はい(True)

PCIe 機能番号。

FunctionType

文字列

はい(True)

PCIe機能のタイプ。

  • Physical:物理 PCIe 機能。

  • Virtual:仮想 PCIe 機能。

Id

文字列

はい(True)

Resource を参照してください。

Links

オブジェクト

はい(True)

このリソースに関連する他のリソースへのリンク。

Name

String

はい(True)

Resource を参照してください。

[ステータス(Status)]

オブジェクト

はい(True)

Resource を参照してください。

RevisionId

文字列

はい(True)

この PCIe 機能のリビジョン ID。

SubsystemId

文字列

はい(True)

この PCIe 機能のサブシステム ID。

SubsystemVendorId

文字列

はい(True)

この PCIe 機能のサブシステム ベンダー ID。

VendorId

文字列

はい(True)

この PCIe 機能のベンダー ID。

ログ サービス コレクションの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Managers/
{{Manager_Instance}} /LogServices Content-Type:application/json

または

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Systems/
{{System_Instance}} /LogServices Content-Type:application/json

応答

JSON 応答のプロパティについては、[コレクション(Collection)] を参照してください。

ログサービスの構成

GET:マネージャ ログ サービス

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Managers/
{{Manager_Instance}}/ LogServices/{{LogService_Instance}} Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します。

表 51. マネージャ ログ サービスのプロパティ

名前

タイプ

読み取り専用

説明

日時(DateTime)

文字列

はい(True)

Redfish タイムスタンプ形式の、ログ サービスの現在の DateTime(UTC からのオフセットあり)。

DateTimeLocalOffset

文字列

はい(True)

DateTime プロパティが設定されている UTC からの時間オフセット(+06:00 フォーマット)。

説明

文字列

はい(True)

Resource を参照してください。

エントリ(Entries)

オブジェクト

はい(True)

このプロパティの値は、LogEntry タイプのリソース コレクションを参照します。

Id

文字列

はい(True)

Resource を参照してください。

Name

String

はい(True)

Resource を参照してください。

OverWritePolicy

文字列

はい(True)

MaxNumberOfRecords に達したとき、またはログがいっぱいになったときのログ サービスのポリシーを示します。

GET:システム ログ サービス

リクエスト

https://<username>:<password>/redfish/v1/Systems/{{System_Instance}}/
LogServices/{{LogService_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 52. システム ログ サービスのプロパティ

名前

タイプ

読み取り専用

説明

[アクション(Actions)]

オブジェクト

はい(True)

このリソースに対して使用可能なアクション。

日時(DateTime)

文字列

はい(True)

Redfish タイムスタンプ形式の、ログ サービスの現在の DateTime(UTC からのオフセットあり)。

DateTimeLocalOffset

文字列

はい(True)

DateTime プロパティが設定されている UTC からの時間オフセット(+06:00 フォーマット)。

説明

文字列

はい(True)

Resource を参照してください。

エントリ(Entries)

オブジェクト

はい(True)

このプロパティの値は、LogEntry タイプのリソース コレクションを参照します。

Id

文字列

はい(True)

Resource を参照してください。

Name

String

はい(True)

Resource を参照してください。

OverWritePolicy

文字列

はい(True)

MaxNumberOfRecords に達したとき、またはログがいっぱいになったときのログ サービスのポリシーを示します。

POST:システム ログ サービスのアクション

リクエスト

curl -sku {{user}}:{{password}} -X POST https://<username>:<password>/redfish/v1/Systems/
system/LogServices/PostCodes/Actions/LogService.ClearLog

または

curl -sku {{user}}:{{password}} -X POST https://<username>:<password>/redfish/v1/Systems/
system/LogServices/EventLog/Actions/LogService.ClearLog

応答

返答はありませんでした。

ログ エントリ コレクションの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Managers/{{Manager_Instance}}/
LogServices/{{LogService_Instance}}/Entries
Content-Type:application/json

または

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Systems/{{System_Instance}}/
LogServices/{{LogService_Instance}}/Entries
Content-Type:application/json

応答

JSON 応答のプロパティについては、[コレクション(Collection)] を参照してください。

ログ エントリの構成

GET:マネージャのジャーナル ログ エントリ

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/Managers/{{Manager_Instance}}/
LogServices/Journal/Entries/{{Entry_Instance}} Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 53. マネージャのジャーナル ログ エントリのプロパティ

名前

タイプ

読み取り専用

説明

Created

文字列

はい(True)

ログ エントリが作成された時刻。

EntryType

文字列

はい(True)

LogEntry のタイプ:Event、SEL、または Oem。

Id

文字列

はい(True)

Resource を参照してください。

メッセージ

文字列

はい(True)

EntryType から復号化されたイベントのメッセージ プロパティ:Event、SEL、または Oem。

MessageArgs

配列

はい(True)

メッセージ内で置換されるメッセージ引数。

Name

String

はい(True)

Resource を参照してください。

OemRecordFormat

文字列

はい(True)

タイプが Oem の場合の、エントリの OEM 固有フォーマット。

解決済み

ブール

False

ログ エントリの問題が解決されたかどうかを示します。

重大度

文字列

はい(True)

ログ エントリの重大度。[OK]、[警告(Warning)]、または [重大(Critical)]。

GET:システム PostCode ログ エントリ

リクエスト

https://<username>:<password>/redfish/v1/Managers/{{Manager_Instance}}/
LogServices/PostCode/Entries/{{Entry_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 54. システム PostCode ログ エントリのプロパティ

名前

タイプ

読み取り専用

説明

Created

文字列

はい(True)

ログ エントリが作成された時刻。

EntryType

文字列

はい(True)

LogEntry のタイプ:Event、SEL、または Oem。

Id

文字列

はい(True)

Resource を参照してください。

メッセージ

文字列

はい(True)

EntryType から復号化されたイベントのメッセージ プロパティ:Event、SEL、または Oem。

MessageArgs

配列

はい(True)

メッセージ内で置換されるメッセージ引数。

MessageId

文字列

はい(True)

EntryType から復号化された、イベントの MessageId プロパティ。

Name

String

はい(True)

Resource を参照してください。

重大度

文字列

はい(True)

ログ エントリの重大度。[OK]、[警告(Warning)]、または [重大(Critical)]。

GET:システム EventLog ログエントリ

リクエスト

https://<username>:<password>/redfish/v1/Managers/{{Manager_Instance}}/
LogServices/EventLog/Entries/{{Entry_Instance}}
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 55. システム EventLog ログ エントリのプロパティ

名前

タイプ

読み取り専用

説明

AdditionalDataURI

文字列

はい(True)

このログ エントリの追加データにアクセスするための URI。

Created

文字列

はい(True)

ログ エントリが作成された時刻。

EntryType

文字列

はい(True)

LogEntry のタイプ:Event、SEL、または Oem。

Id

文字列

はい(True)

Resource を参照してください。

メッセージ

文字列

はい(True)

EntryType から復号化されたイベントのメッセージ プロパティ:Event、SEL、または Oem。

変更日

文字列

はい(True)

ログ エントリが最後に変更された日付と時刻。

Name

String

はい(True)

Resource を参照してください。

解決済み

ブール

False

ログ エントリの問題が解決されたかどうかを示します。

重大度

文字列

はい(True)

ログ エントリの重大度。[OK]、[警告(Warning)]、または [重大(Critical)]。

セッション サービスの構成

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/SessionService
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 56. セッション サービスのプロパティ

名前

タイプ

読み取り専用

説明(Description)

説明

文字列

はい(True)

Resource を参照してください。

Id

文字列

はい(True)

Resource を参照してください。

Name

String

はい(True)

Resource を参照してください。

ServiceEnabled

ブール

True

このサービスが有効になっているかどうかを示します。デフォルト値は null です。

SessionTimeout

物理ポートの

いいえ(False)

セッション サービスがセッションを終了するまでの非アクティブ時間(秒)。最小値:30、最大値:86400。

セッション

オブジェクト

はい(True)

このプロパティには、セッションのコレクションへのリンクが含まれます。

PATCH

リクエスト

curl -sku {{user}}:{{password}} -X PATCH https://<username>:<password>/redfish/v1/SessionService 
-H "Content-Type:application/json" -d '{"SessionTimeout": 100}'

レスポンス

{
    "SessionTimeOut@Message.ExtendedInfo": [
        {
            "@odata.type": "#Message.v1_1_1.Message",
            "Message": "The property SessionTimeOut was assigned the value '100' due to modification by the service.",
            "MessageArgs": [
                "SessionTimeOut",
                "100"
            ],
            "MessageId": "Base.1.13.0.PropertyValueModified",
            "MessageSeverity": "Warning",
            "Resolution": "No resolution is required."
        }
    ]
}

セッション コレクションの構成

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/SessionService/Sessions
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、[コレクション(Collection)] を参照してください。

POST

リクエスト

curl -sku {{user}}:{{password}} -X POST https://<username>:<password>/redfish/v1/
SessionService/Sessions -H "Content-Type:application/json" -d '{"UserName": "root", 
"Password": "0penBmc", "Context": "test"}'

レスポンス

{
    "@odata.id": "/redfish/v1/SessionService/Sessions/LtSHscNj2a",
    "@odata.type": "#Session.v1_5_0.Session",
    "ClientOriginIPAddress": "10.36.25.248",
    "Context": "test",
    "Description": "Manager User Session",
    "Id": "LtSHscNj2a",
    "Name": "User Session",
    "UserName": "root"
}

セッション プロパティの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/SessionService/
Sessions/{{Session_Instance}}Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 57. セッション プロパティ

名前

タイプ

読み取り専用

説明

ClientOriginIPAddress

文字列

はい(True)

セッションを作成したクライアントの IP アドレス。

説明

文字列

はい(True)

Resource を参照してください。

Id

文字列

はい(True)

Resource を参照してください。

Name

String

はい(True)

Resource を参照してください。

UserName

文字列

はい(True)

このセッションのアカウントのユーザー名。この値は、アカウント サービスに登録されている ManagerAccount リソースによって識別される、登録済みアカウントと一致します。

タスクのサービス プロパティの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/TaskService
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 58. タスクのサービス プロパティ

名前

タイプ

読み取り専用

説明

CompletedTaskOverWritePolicy

文字列

はい(True)

タスク サービスが追加のタスクを追跡する必要がある場合に、完了したタスクをどのように処理するかを示します。

日時(DateTime)

文字列

はい(True)

TaskService の現在の DateTime 値。Redfish Timestamp フォーマットで、UTC からのオフセットを含みます。

Id

文字列

はい(True)

Resource を参照してください。

LifeCycleEventOnTaskStateChange

ブール

True

サービスが、タスク状態の変更時に、そのようなイベントに登録されているリスナーの宛先にライフ サイクル イベントを送信するかどうかを示します。

Name

String

はい(True)

Resource を参照してください。

ServiceEnabled

ブール

True

このサービスが有効になっているかどうかを示します。

[ステータス(Status)]

オブジェクト

はい(True)

Resource を参照してください。

タスク

オブジェクト

はい(True)

タスク コレクション タイプのリソースへのリンク。

タスク コレクションの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/TaskService/Tasks
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、[コレクション(Collection)] を参照してください。

タスク プロパティの表示

GET

リクエスト

curl -k -u <username>:<password> https://<BMC IP>/redfish/v1/TaskService/
Tasks/{{Task_Instance}}Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 59. タスクのプロパティ

名前

タイプ

読み取り専用

説明

EndTime

文字列

はい(True)

タスクが完了した日付と時刻。タスクが完了した場合にのみ表示されます。

Id

文字列

はい(True)

Resource を参照してください。

メッセージ

配列

はい(True)

タスクに関連付けられたメッセージの配列。オブジェクトフォーマットについては、 表 2 を参照してください。

Name

String

はい(True)

Resource を参照してください。

ペイロード

オブジェクト

はい(True)

このタスクの HTTP および JSON ペイロードの詳細(サービスによって非表示にされていない場合)。

PercentComplete

物理ポートの

はい(True)

このタスクの完了率。

StartTime

文字列

はい(True)

タスクが開始された日付と時刻。

TaskMonitor

文字列

はい(True)

このタスクのタスクモニターの URI。

TaskState

文字列

はい(True)

タスクの状態。

  • Canceled:タスクはキャンセルされました。

  • Cancelling:タスクはキャンセル中です。

  • Completed:タスクは完了しました。

  • Exception:例外によりタスクが停止しました。

  • Interrupted:タスクは中断されました。

  • kill:タスクは終了させられました。

  • New:新規タスクです。

  • Pending:タスクは保留中であり、開始されていません。

  • Running:タスクは通常の方法で実行中です。

  • Service:タスクはサービスとして実行中です。

  • Starting:タスクは開始中です。

  • Stopping:タスクは停止中です。

  • Suspended:タスクは一時停止されています。

task-status

文字列

はい(True)

Redfish 仕様で定義されている、タスクの完了ステータス。

表 60. メッセージ プロパティ

名前

タイプ

読み取り専用

説明

@odata.type

文字列

はい(True)

OData プロパティ を参照してください。

メッセージ

文字列

はい(True)

人間が読めるメッセージ。

MessageArgs

配列

はい(True)

メッセージ内で置換されるメッセージ引数の配列。

MessageId

文字列

はい(True)

メッセージの一意の識別子。

MessageSeverity

文字列

はい(True)

メッセージの重大度。

対処法

文字列

はい(True)

メッセージの解決方法。デフォルトよりも具体的である場合があります。

更新サービスの構成

GET

リクエスト

https://{{IP}}/redfish/v1/UpdateService
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 61. UpdateService プロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

説明

文字列

はい(True)

リソースを参照してください。

FirmwareInventory

オブジェクト

はい(True)

FirmwareInventoryCollection タイプのリソースへのリンク。

HttpPushUri

文字列

はい(True)

URI は更新サービスへの HTTP または HTTPS プッシュ更新を実行するために使用されます。

HttpPushUriOptions

オブジェクト

いいえ(False)

Redfish 仕様で定義されたマルチパート HTTP または HTTPS プッシュ更新の URI。表 2 を参照してください。

HttpPushUriApplyTime

オブジェクト

いいえ(False)

このプロパティには、HttpPushUri を介して提供されたファームウェアを適用するタイミングの設定が含まれています。

表 2 を参照してください。

Id

文字列

はい(True)

リソースを参照してください。

MaxImageSizeBytes

物理ポートの

はい(True)

サポートされるソフトウェア更新イメージの最大サイズ(バイト単位)。

Name

String

はい(True)

リソースを参照してください。

ServiceEnabled

ブール

True

このサービスが有効になっているかどうかを示します。

表 62. HttpPushUriApplyTime プロパティ

名前

タイプ

読み取り専用

説明

ApplyTime

文字列

いいえ(False)

HttpPushUri 経由で呼び出されたソフトウェア更新を適用するタイミングを示します。

  • Immediate:すぐに適用されます。

  • OnReset:リセット時に適用されます。

PATCH

リクエスト

curl -sku {{username}}:{{password}} -X PATCH https://{{IP}}/redfish/v1/UpdateService -H "Content-Type:application/json" -d '{"HttpPushUriOptions": {"HttpPushUriApplyTime": {"ApplyTime": "Immediate"}}}'

レスポンス

{
"@Message.ExtendedInfo": [
{
"@odata.type": "#Message.v1_1_1.Message",
"Message": "The request completed successfully.",
"MessageArgs": [],
"MessageId": "Base.1.13.0.Success",
"MessageSeverity": "OK",
"Resolution": "None"
}
]
}

POST

リクエスト

curl -sku {{username}}:{{password}} -X POST https://{{IP}}/redfish/v1/UpdateService -H "Content-Type:application/octet-stream" --data-binary @$file

レスポンス

{
"@odata.id": "/redfish/v1/TaskService/Tasks/0",
"@odata.type": "#Task.v1_4_3.Task",
"Id": "0",
"TaskState": "Running",
"TaskStatus": "OK"
}

ファームウェア インベントリ コレクションの表示

GET

リクエスト

https://{{IP}}/redfish/v1/UpdateService/FirmwareInventory
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、コレクション を参照してください。

CPU 電力制限のプロパティの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/CPU/Power
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 63. CPU 電力制限情報のプロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

説明

文字列

はい(True)

リソースを参照してください。

メッセージ

文字列

はい(True)

人間が読めるメッセージ。

PowerInfo

オブジェクト

はい(True)

CPU 電力制限に関する情報を提供します。

表 64. CPU 電力制限のプロパティ

名前

タイプ

読み取り専用

説明

制限

物理ポートの

はい(True)

電力制限の設定値。

CappingMax

物理ポートの

はい(True)

最大電力制限設定値

CappingMin

物理ポートの

はい(True)

最小電力制限設定値。

Name

String

はい(True)

リソースを参照してください。

電源

物理ポートの

はい(True)

現在の電力測定値。

POST

リクエスト

curl -sku {{username}}:{{password}} -X POST https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/CPU/Power
-H "Content-Type:application/json" -d ‘{ "Power Capping": {{power capping value}} }’

レスポンス

{
"Message": "Success."
}

CPU 電力制限の復元

POST

リクエスト

curl -sku {{username}}:{{password}} -X POST
https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/CPU/Power/Restore -H "Content-Type:application/json"

レスポンス

{
"Message": "Success."
}

ファームウェア イメージのアップロード

POST

MI300X ファームウェア イメージのアップロード

リクエスト

curl -sku {{username}}:{{password}} -X POST https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/UploadFile -
H "Content-Type:application/octet-stream" -H "Filename: amdfw.pldm" –data-binary @{{GPU firmware image}}

レスポンス

{
"Filename": "amdfw.pldm",
"Result": "Success."
}

BIOS/FPGA ファームウェア イメージのアップロード

リクエスト

curl -sku {{username}}:{{password}} -X POST https://{{IP}}/redfish/v1/SManagers/bmc/Oem/OemManagement/UploadFile -
H "Content-Type:application/octet-stream" -H "Filename: oem.bin" --data-binary @{{firmware image}}

レスポンス

{
"Filename": "oem.bin",
"Result": "Success."
}

GPU 管理コレクションの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/GPU
Content-Type:application/json

レスポンス

JSON 応答のプロパティについては、コレクション を参照してください。

GPU センサー プロパティの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/GPU/Sensor
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 65. GPU センサー プロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

説明

文字列

はい(True)

リソースを参照してください。

電源

オブジェクト

はい(True)

GPU 電力を一覧表示します。 GPU 電源センサーのプロパティを参照してください。

温度

オブジェクト

はい(True)

GPU 温度が一覧表示されます。 GPU 温度センサーのプロパティを参照してください。

表 66. GPU 電源センサーのプロパティ

名前

タイプ

読み取り専用

説明

MaxValue

物理ポートの

はい(True)

最大電力値。単位は、関連する [Reading] プロパティで使用されるものと同じにすることができます。

MinValue

物理ポートの

はい(True)

最小電力値。単位は、関連する [Reading] プロパティで使用されるものと同じにすることができます。

Name

String

はい(True)

リソースを参照してください。

ユニット(Units)

文字列

はい(True)

読み取りの測定単位。

値

物理ポートの

はい(True)

センサーの読み取り。

表 67. GPU 温度センサーのプロパティ

名前

タイプ

読み取り専用

説明

CriticalHigh

物理ポートの

はい(True)

温度のクリティカル上限しきい値を示します。

CriticalLow

物理ポートの

はい(True)

温度のクリティカル下限しきい値を示します。

MaxValue

物理ポートの

はい(True)

[Reading] の最大値。単位は、関連する [Reading] プロパティで使用されるものと同じにすることができます。

MinValue

物理ポートの

はい(True)

[Reading] で可能な最小値。単位は、関連する [Reading] プロパティで使用されるものと同じにすることができます。

Name

String

はい(True)

リソースを参照してください。

ユニット(Units)

文字列

はい(True)

読み取りの測定単位。

値

物理ポートの

はい(True)

センサーの読み取り。

GPU 電力制限のプロパティの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/GPU/Power
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 68. [GPU 電力制限情報(GPU Power Capping Information)] プロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

説明

文字列

はい(True)

リソースを参照してください。

PowerInfo

オブジェクト

はい(True)

GPU 電力制限が一覧表示されます。 「GPU 電力制限のプロパティ」を参照してください。

表 69. GPU 電力制限プロパティ

名前

タイプ

読み取り専用

説明

制限

物理ポートの

はい(True)

電力制限の設定値。

Name

String

はい(True)

リソースを参照してください。

電源

物理ポートの

はい(True)

現在の電力測定値。

POST

リクエスト

curl -sku {{username}}:{{password}} -X POST https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/Power -H 
"Content-Type:application/json" -d ‘{ "Power Capping": {{power capping value}} }’

レスポンス

{
"Message": "Success."
}

GPU 電力制限の復元

POST

リクエスト

curl -sku {{username}}:{{password}} -X POST
https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/GPU/Power/Restore -H "Content-Type:application/json"

レスポンス

{
"Message": "Success."
}

GPU ファームウェア バージョンの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/GPU/FirmwareVersion
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 70. GPU ファームウェア バージョン情報のプロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

説明

文字列

はい(True)

リソースを参照してください。

バージョン

オブジェクト

はい(True)

GPU ファームウェア バージョンを一覧表示します。 GPU ファームウェア バージョンのプロパティを参照してください。

表 71. GPU ファームウェア バージョンのプロパティ

名前

タイプ

読み取り専用

説明

名前

String

はい(True)

リソースを参照してください。

バージョン

文字列

はい(True)

ファームウェア バージョン。

GPU イベント ログの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/GPU/EventLog/Entries
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 72. GPU イベント ログ情報のプロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

説明

文字列

はい(True)

リソースを参照してください。

メンバー

オブジェクト

はい(True)

このコレクションのメンバー。 GPU イベント ログのプロパティを参照してください。

表 73. GPU イベント ログのプロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

Created

文字列

はい(True)

ログ エントリが作成された時刻。

EntryType

文字列

はい(True)

LogEntry のタイプを表します。リソースが IPMI SEL ログ エントリを表す場合、値は SEL となります。リソースがイベントログを表す場合、値は Event となります。リソースが OEM ログ形式を表す場合、値は Oem となります。列挙型は、Event、SEL、または Oem です。

Id

文字列

はい(True)

リソースを参照してください。

Links

オブジェクト

はい(True)

このリソースに関連する他のリソースへのリンク。

メッセージ

文字列

はい(True)

イベントのメッセージ プロパティと EntryType からの復号。EntryType が「Event」の場合、それはメッセージの説明です。EntryType が「SEL」の場合は SEL 固有のメッセージが含まれ、それ以外の場合は OEM 固有のログ エントリが含まれます。ほとんどの場合、このプロパティには実際のログ エントリが含まれます。

MessageArgs

配列

はい(True)

メッセージ レジストリで検索されたときにメッセージ内の引数と置換されるメッセージ引数の配列。

MessageId

文字列

はい(True)

MessageId、イベントデータ、または OEM 固有の情報。

Name

String

はい(True)

リソースを参照してください。

対処法

文字列

はい(True)

ログエントリの原因となった状況を解決する方法についての提案を提供します。

重大度

文字列

はい(True)

ログ エントリのシビラティ(重大度)。次の列挙値のいずれかにすることができます。

  • OK

  • 警告

  • クリティカル

GPU ファームウェアのアップデート

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/GPU/FwUpdate
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 74. GPU ファームウェア バージョン情報のプロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

アクション(Actions)

オブジェクト

はい(True)

このリソースに対して利用可能なアクション。

説明

文字列

はい(True)

リソースを参照してください。

UpdateStatus

オブジェクト

はい(True)

GPU ファームウェア アップデートのステータスへのリンク。

POST

リクエスト

curl -sku {{username}}:{{password}} -X POST
https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/GPU/FwUpdate -H "Content-Type:application/json"

レスポンス

{
"@odata.id": "/redfish/v1/TaskService/Tasks/0",
"@odata.type": "#Task.v1_4_3.Task",
"Id": "0",
"TaskState": "Starting",
"TaskStatus": "OK"
}

GPU ファームウェアの更新ステータスの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/GPU/UpdateStatus
Content-Type:application/json

レスポンス

更新が進行中の場合:

{
"Status": "Running"
}

更新が成功した場合:

{
"Status": "Success"
}

OEM デバイス ファームウェアの更新

POST

リクエスト

curl -sku {{username}}:{{password}} -X POST https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/OEMUpdate
-H "Content-Type:application/json" -d ‘{ "updateDevice": "{{device}}" }’

レスポンス

{
"Result": "Success."
}

OEM デバイス ファームウェアの更新ステータスの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/OEMUpdate/CheckStatus
Content-Type:application/json

レスポンス


(注)  


更新が進行中の場合、応答はありません。


更新が成功すると、次の応答が返されます。

{
"Result": "Success."
}

NVMe の現在のプロパティの表示

GET

リクエスト

https://{{IP}}/redfish/v1/Managers/bmc/Oem/OemManagement/NVMePresence
Content-Type:application/json

レスポンス

要求への応答は JSON フォーマットになります。プロパティを次の表に示します:

表 75. NVMe プレゼン情報のプロパティ

名前

タイプ

読み取り専用

説明

@odata.id

文字列

はい(True)

ODATA プロパティ を参照してください。

@odata.type

文字列

はい(True)

ODATA プロパティ を参照してください。

説明

文字列

はい(True)

リソースを参照してください。

[ステータス(Status)]

オブジェクト

はい(True)

NVMe の現在のステータスをリストします。 「NVMe Present プロパティ」を参照してください。

表 76. NVMe Present プロパティ

名前

タイプ

読み取り専用

説明

名前

String

はい(True)

リソースを参照してください。

[ステータス(Status)]

文字列

はい(True)

リソースのステータス。

  • Present:このデバイスが存在します。

  • Not Present:このデバイスは存在しません。

テクニカル サポート ログの表示

GET

ログの収集と tar ball としての保存

リクエスト

https://{{IP}}/redfish/v1/Managers/bmc/Oem/TechSupportLogs
Content-Type:application/json

レスポンス

{
"Result": "Success."
}

tar ball のローカルへのダウンロード

リクエスト

curl -s -k -X GET https://{{username}}:{{password}}@{{IP}}/redfish/v1/Managers/bmc/Oem/TechSupportLogs/attachment
>/tmp/c885a.tgz

レスポンス

{
"Result": "Success."
}

BMC と GPU との同期

POST

リクエスト

curl -k -u root:password -H 'Content-Type:application/json' -X POST https://{{IP}}/redfish/v1/Managers/bmc/Actions
/Oem/OemManager.SyncGpuDateTime -d '{"ActionType":"SyncImmediately"}'

レスポンス

{
"GpuDateTime": {“DateTime”: “2024-12-28 08:00:40”}
}