nvmet.host_subsys.update

Update host/subsys association of id.

Type: object

Call parameters

Type: array
No Additional Items

Tuple Validation

Parameter 1: id

id

Type: integer

ID of the host-subsystem association to update.

Parameter 2: nvmet_host_subsys_update

nvmet_host_subsys_update

Type: object

Updated host-subsystem association configuration data.

No Additional Properties

host_id

Host Id

Type: integer

ID of the NVMe-oF host to authorize.

subsys_id

Subsys Id

Type: integer

ID of the NVMe-oF subsystem to grant access to.

Return value

NVMetHostSubsysEntry

Type: object

The updated host-subsystem association.

No Additional Properties

id Required

Id

Type: integer

Unique identifier for the host-subsystem association.

host Required

NVMetHostEntry

Type: object

NVMe-oF host that is authorized to access the subsystem.

No Additional Properties

id Required

Id

Type: integer

Unique identifier for the NVMe-oF host.

hostnqn Required

Hostnqn

Type: string

NQN of the host that will connect to this TrueNAS.

Must be at least 1 characters long

description

Description

Type: string Default: ""

Description of the NVMet host.

dhchap_key

Dhchap Key

Default: null

If set, the secret that the host must present when connecting.

A suitable secret can be generated using nvme gen-dhchap-key, or by using the nvmet.host.generate_key API.

Any of

• Option 1
• Option 2

Type: string

Must be at least 1 characters long

Type: null

dhchap_ctrl_key

Dhchap Ctrl Key

Default: null

If set, the secret that this TrueNAS will present to the host when the host is connecting (Bi-Directional Authentication).

A suitable secret can be generated using nvme gen-dhchap-key, or by using the nvmet.host.generate_key API.

Any of

• Option 1
• Option 2

Type: string

Must be at least 1 characters long

Type: null

dhchap_dhgroup

Dhchap Dhgroup

Default: null

If selected, the DH (Diffie-Hellman) key exchange built on top of CHAP to be used for authentication.

Any of

• Option 1
• Option 2

Type: enum (of string)

Must be one of:

• "2048-BIT"
• "3072-BIT"
• "4096-BIT"
• "6144-BIT"
• "8192-BIT"

Type: null

dhchap_hash

Dhchap Hash

Type: enum (of string) Default: "SHA-256"

HMAC (Hashed Message Authentication Code) to be used in conjunction if a dhchap_dhgroup is selected.

Must be one of:

• "SHA-256"
• "SHA-384"
• "SHA-512"

subsys Required

Type: object

NVMe-oF subsystem that the host is authorized to access.

Required roles: SHARING_NVME_TARGET_WRITE