Skip to content

Commit efaface

Browse files
author
James DeFelice
committed
address review feedback
1 parent 652fa46 commit efaface

File tree

3 files changed

+329
-347
lines changed

3 files changed

+329
-347
lines changed

csi.proto

Lines changed: 18 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -250,20 +250,14 @@ message VolumeInfo {
250250
string id = 2;
251251

252252
// Attributes reflect static properties of a volume and MUST be passed
253-
// to volume validation and publishing calls. Attributes MAY NOT
254-
// uniquely identify a volume. A volume uniquely identified by `id`
255-
// SHALL always report the same attributes. This field is REQUIRED.
256-
Attributes attributes = 3;
257-
}
258-
259-
// Attributes are generally specific to the system that generated them:
260-
// CO-generated attributes SHALL be opaque to a plugin, and plugin-
261-
// generated attributes SHALL be opaque to a CO. Attributes SHALL NOT
262-
// be mutable and SHALL be safe for any party to cache. Attributes
263-
// SHOULD NOT contain sensitive information.
264-
message Attributes {
265-
// This field is OPTIONAL.
266-
map<string,string> values = 1;
253+
// to volume validation and publishing calls.
254+
// Attributes SHALL be opaque to a CO. Attributes SHALL NOT be mutable
255+
// and SHALL be safe for the CO to cache. Attributes SHOULD NOT
256+
// contain sensitive information. Attributes MAY NOT uniquely identify
257+
// a volume. A volume uniquely identified by `id` SHALL always report
258+
// the same attributes. This field is OPTIONAL and when present MUST
259+
// be passed to volume validation and publishing calls.
260+
map<string,string> attributes = 3;
267261
}
268262

269263
// A standard way to encode credential data. The total bytes of the
@@ -335,8 +329,9 @@ message ControllerPublishVolumeRequest {
335329
Credentials user_credentials = 6;
336330

337331
// Attributes of the volume to be used on a node. This field is
338-
// REQUIRED.
339-
Attributes volume_attributes = 7;
332+
// OPTIONAL and MUST match the attributes of the VolumeInfo identified
333+
// by `volume_id`.
334+
map<string,string> volume_attributes = 7;
340335
}
341336

342337
message ControllerPublishVolumeResponse {
@@ -410,8 +405,9 @@ message ValidateVolumeCapabilitiesRequest {
410405
// specified below are supported. This field is REQUIRED.
411406
repeated VolumeCapability volume_capabilities = 3;
412407

413-
// Attributes of the volume to check. This field is REQUIRED.
414-
Attributes volume_attributes = 4;
408+
// Attributes of the volume to check. This field is OPTIONAL and MUST
409+
// match the attributes of the VolumeInfo identified by `volume_id`.
410+
map<string,string> volume_attributes = 4;
415411
}
416412

417413
message ValidateVolumeCapabilitiesResponse {
@@ -584,8 +580,10 @@ message NodePublishVolumeRequest {
584580
// request. This field is OPTIONAL.
585581
Credentials user_credentials = 7;
586582

587-
// Attributes of the volume to publish. This field is REQUIRED.
588-
Attributes volume_attributes = 8;
583+
// Attributes of the volume to publish. This field is OPTIONAL and
584+
// MUST match the attributes of the VolumeInfo identified by
585+
// `volume_id`.
586+
map<string,string> volume_attributes = 8;
589587
}
590588

591589
message NodePublishVolumeResponse {

0 commit comments

Comments
 (0)